Name

       AuDeviceAttributes - device attributes structure

Structures

       #include <audio/audiolib.h>

       typedef struct _AuDeviceAttributes
       {
           . . .
       }AuDeviceAttributes;

Members

       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.

       AuDeviceIdentifier(da)
                 Accesses the AuFlowID ID of the device.

       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.

Description

       The AuDeviceAttributes structure describes the physical hardware interface.

See Also

       AuGetDeviceAttributes, AuListDevices.

       audiolib - Network Audio System C Language Interface