08-17-2013, 04:36 PM
(This post was last modified: 08-03-2014, 08:57 AM by Dean Roddey.)
General Description
This thread is for discussion of the Audio device class. Drivers that implement this device class provide volume and mute control on an audio source.
This is one of those 'fractional' device classes. I.e. it's unlikely any driver would just implement this one class. It will be implemented in addition to other things.
Fields Provided
[INDENT]The fields provided by this device class have pre-determined names, and these MUST be implemented as indicated here. They are all prefixed by the device class prefix in one of the forms:
AUD#fieldname
AUD#sub~fieldname
where AUD# indicates it is a field of this device class, and fieldname meets the general requirements of CQC field names. If the device provides more than one audio source, then the sub~ part will be present and will indicate the specific source instances, see the Multi-Unit section below.
The fields provided by this class are:
Power Management Issues
[INDENT]Any drivers that implements this class MUST also implement Power.[/INDENT]
Multi-Unit Considerations
[INDENT]Though in the bulk of cases a given driver will only control one media source, there are exceptions, such as multi-zone audio systems or multi-zone A/V receivers.
It is RECOMMENDED that the sub-unit names be user definable, as that provides the most self-documenting field names. However they MAY be just assigned based on zone numbers, e.g. Z1, Z2, etc... or some other appropriate scheme, perhaps gotten from the device itself.[/INDENT]
Backdoor Commands/Queries
[INDENT]None are required at this time.[/INDENT]
This thread is for discussion of the Audio device class. Drivers that implement this device class provide volume and mute control on an audio source.
This is one of those 'fractional' device classes. I.e. it's unlikely any driver would just implement this one class. It will be implemented in addition to other things.
Fields Provided
[INDENT]The fields provided by this device class have pre-determined names, and these MUST be implemented as indicated here. They are all prefixed by the device class prefix in one of the forms:
AUD#fieldname
AUD#sub~fieldname
where AUD# indicates it is a field of this device class, and fieldname meets the general requirements of CQC field names. If the device provides more than one audio source, then the sub~ part will be present and will indicate the specific source instances, see the Multi-Unit section below.
The fields provided by this class are:
- AdjustVolume. This field allows for incremental adjustment up or down of the volume relative to its current value. It MUST be marked with the VolumeAdj semantic field type and conform to the definition of that type.
- Mute. This field allows the audio stream to be muted or unmuted. It MUST be marked with the Mute semantic field type and conform to the definition of that type.
- Volume. This field allows control over the volume of the audio source. It MUST be marked with the Volume semantic field type and conform to the definition of that type.
Power Management Issues
[INDENT]Any drivers that implements this class MUST also implement Power.[/INDENT]
Multi-Unit Considerations
[INDENT]Though in the bulk of cases a given driver will only control one media source, there are exceptions, such as multi-zone audio systems or multi-zone A/V receivers.
It is RECOMMENDED that the sub-unit names be user definable, as that provides the most self-documenting field names. However they MAY be just assigned based on zone numbers, e.g. Z1, Z2, etc... or some other appropriate scheme, perhaps gotten from the device itself.[/INDENT]
Backdoor Commands/Queries
[INDENT]None are required at this time.[/INDENT]
Dean Roddey
Explorans limites defectum
Explorans limites defectum