AAM_AudioIoControl

This function routes the DeviceIoControl function to the appropriate device drivers.

Syntax

DWORD AAM_AudioIoControl ( DWORD dwFlag, DWORD dwIoControlCode, LPVOID lpInBuf, DWORD nInBufSize, LPVOID lpOutBuf, DWORD nOutBufSize, LPDWORD lpBytesReturned, LPOVERLAPPED lpOverLapped );

Parameters

dwFlag

Specifies a bitmask for flags. It is one of the following values:

AAM_FLAG_IEQ: Calls EQ-related device drivers.
AAM_FLAG_ISSD: Calls surround sound-related device drivers.
AAM_FLAG_IVOLUME: Calls volume-related device drivers.

dwIoControlCode

Specifies the control code of the operation to perform.

lpInBuf

Long pointer to a buffer that supplies input data to the DeviceIoControl function.

nInBufSize

Size of input buffer.

lpOutBuf

Long pointer to buffer that receives output data from the DeviceIoControl function.

nOutBufSize

Size of output buffer.

lpBytesReturned

Long pointer to the variable that receives output byte count.

lpOverLapped

Long pointer to an OVERLAPPED structure.

Return Values

Zero indicates success. AAM_ERR_DEVICEFAIL indicates that the device failed to respond. AAM_ERR_NOTSUPPORTED indicates that no device driver is available.

If the DeviceIoControl succeeds (returns non-zero), this function returns 0. If DeviceIoControl fails (returns zero), this function returns AAM_ERR_DEVICEFAIL.

This function returns a flag. Based on the dwFlag value, this function routes the DeviceIoControl function to the appropriate device.