ACMDRVFORMATSUGGEST

See also ACMDM_FORMAT_DETAILS, ACMDM_FORMAT_SUGGEST, ACMDM_FORMATTAG_DETAILS


typedef struct {
    DWORD cbStruct;          
    DWORD fdwSuggest;        
    LPWAVEFORMATEX pwfxSrc;  
    DWORD cbwfxSrc;          
    LPWAVEFORMATEX pwfxDst;  
    DWORD cbwfxDst;          
} ACMDRVFORMATSUGGEST;

Contains information needed by an Audio Compression Manager (ACM) driver to respond to the ACMDM_FORMAT_SUGGEST message. The lParam1 parameter of the acmDriverProc function will contain a pointer to this structure during the ACMDM_FORMAT_SUGGEST message.

cbStruct

Size, in bytes, of the ACMDRVFORMATSUGGEST structure. This member will be initialized by the ACM before calling the driver. This member can be greater than the size, in bytes, of the base ACMDRVFORMATSUGGEST structure. An ACM driver should ignore any members that are not contained in the base ACMDRVFORMATSUGGEST structure. This member should not be modified by the driver.

fdwSuggest

Flags for matching the desired destination format. This member should not be modified by the driver.

ACM_FORMATSUGGESTF_NCHANNELS

Specifies that the nChannels member of the pwfxDst member of the ACMDRVFORMATSUGGEST structure is valid. The driver should only suggest formats that can be converted from the format given in the pwfxSrc member of the ACMDRVFORMATSUGGEST structure matching the destination nChannels member, or fail.

ACM_FORMATSUGGESTF_NSAMPLESPERSEC

Specifies that the nSamplesPerSec member of the pwfxDst member of the ACMDRVFORMATSUGGEST structure is valid. The driver should only suggest formats that can be converted from the format given in the pwfxSrc member of the ACMDRVFORMATSUGGEST structure matching the destination nSamplesPerSec member, or fail.

ACM_FORMATSUGGESTF_WBITSPERSAMPLE

Specifies that the wBitsPerSample member of the pwfxDst member of the ACMDRVFORMATSUGGEST structure is valid. The driver should only suggest formats that can be converted from the format given in the pwfxSrc member of the ACMDRVFORMATSUGGEST structure matching the destination wBitsPerSample member, or fail.

ACM_FORMATSUGGESTF_WFORMATTAG

Specifies that the wFormatTag member of the pwfxDst member of the ACMDRVFORMATSUGGEST structure is valid. The driver should only suggest formats that can be converted from the format given in the pwfxSrc member of the ACMDRVFORMATSUGGEST structure matching the destination wFormatTag member, or fail.


pwfxSrc

Address of a WAVEFORMATEX structure that identifies the source format to suggest a destination format to be used for a conversion. This member should not be modified by the driver.

cbwfxSrc

Size, in bytes, of the WAVEFORMATEX structure pointed to by the pwfxSrc member of the ACMDRVFORMATSUGGEST structure. This member should not be modified by the driver.

pwfxDst

Address of a WAVEFORMATEX data structure to receive the suggested destination format for the source format pointed to by the pwfxSrc member of the ACMDRVFORMATSUGGEST structure. Note that, based on the fdwSuggest member, some members of the structure pointed to this member may be specified. The driver should use this buffer to return the suggested destination format.

cbwfxDst

Size, in bytes, of the WAVEFORMATEX structure pointed to by the pwfxDst member of the ACMDRVFORMATSUGGEST structure that is available for the suggested format. This member should not be modified by the driver.