DragonFly On-Line Manual Pages

AuDeviceAttributes(3)                       DragonFly Library Functions Manual

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

audiolib - device attributes structure
                                     1.9.4               AuDeviceAttributes(3)