AuDeviceAttributes

Name

AuDeviceAttributes - device attributes structure

#include <audio/audiolib.h>

typedef struct _AuDeviceAttributes

{

. . .

} AuDeviceAttributes;

Do not dereference the members of the AuDeviceAttributes structure directly. Instead use the access macros.

da is a pointer to a AuDeviceAttributes structure.

AuDeviceValueMask(da): Accesses the AuMask value indicating what attributes are present. This is a bitwise inclusive OR of these constants: AuCompCommonIDMask, AuCompCommonKindMask, AuCompCommonUseMask, AuCompCommonFormatMask, AuCompCommonNumTracksMask, AuCompCommonAccessMask, AuCompCommonDescriptionMask, AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSampleRateMask, AuCompDeviceLocationMask, AuCompDeviceGainMask, AuCompDeviceLineModeMask, and AuCompDeviceChildrenMask.

AuDeviceChangableMask(da): Accesses the AuMask value indicating which attributes can be changed. This is a bitwise inclusive OR of these constants: AuCompCommonIDMask, AuCompCommonKindMask, AuCompCommonUseMask, AuCompCommonFormatMask, AuCompCommonNumTracksMask, AuCompCommonAccessMask, AuCompCommonDescriptionMask, AuCompDeviceMinSampleRateMask, AuCompDeviceMaxSampleRateMask, AuCompDeviceLocationMask, AuCompDeviceGainMask, AuCompDeviceLineModeMask, and AuCompDeviceChildrenMask.

AuDeviceKind(da): Accesses the int value indicating the kind of component. Devices are either AuComponentKindPhysicalInput or AuComponentKindPhysicalOutput.

AuDeviceUse(da): Accesses the AuMask value indicating what uses of the device are permitted. This is a bitwise inclusive OR of these constants: AuComponentUseImportMask and AuComponentUseExportMask.

AuDeviceFormat(da): Accesses the int value indicating the audio data format the device uses. Currently, the following formats are defined: AuFormatULAW8, AuFormatLinearUnsigned8, AuFormatLinearSigned8, AuFormatLinearSigned16MSB, AuFormatLinearUnsigned16MSB, AuFormatLinearSigned16LSB, and AuFormatLinearUnsigned16LSB.

AuDeviceNumTracks(da): Accesses the int value indicating the number of tracks the device supports.

AuDeviceAccess(da): Accesses the AuMask value indicating what kinds of access are allowed. This is a bitwise inclusive OR of these constants: AuAccessImportMask, AuAccessExportMask, AuAccessDestroyMask, and AuAccessListMask.

AuDeviceDescription(da): Accesses the AuString structure containing a textual description of the device.

AuDeviceMinSampleRate(da): Accesses the unsigned int value indicating the minimum sample rate supported by the device.

AuDeviceMaxSampleRate(da): Accesses the unsigned int value indicating the maximum sample rate supported by the device.

AuDeviceLocation(da): Accesses the AuMask value indicating the location of the device. This is a bitwise inclusive OR of these constants: AuDeviceLocationLeftMask, AuDeviceLocationCenterMask, AuDeviceLocationRightMask, AuDeviceLocationTopMask, AuDeviceLocationMiddleMask, AuDeviceLocationBottomMask, AuDeviceLocationBackMask, AuDeviceLocationFrontMask, AuDeviceLocationInternalMask, and AuDeviceLocationExternalMask

AuDeviceGain(da): Accesses the AuFixedPoint value with the current hardware amplification level.

AuDeviceLineMode(da): Accesses the AuInt32 value indicating the current line mode (input device only).

AuDeviceNumChildren(da): Accesses the int value indicating the number of subcomponents of the device.

AuDeviceChildren(da): Accesses the list of AuDeviceID's of the subcomponents of the device.

The AuDeviceAttributes structure describes the physical hardware interface.