ACMDRVFORMATSUGGEST

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

The ACMDRVFORMATSUGGEST structure contains client-specified input arguments to the acmFormatSuggest function. The ACM fills in this structure with the client’s input arguments and passes it to an ACM driver with an ACMDM_FORMAT_SUGGEST message. ACMDRVFORMATSUGGEST is defined in msacmdrv.h.

Members

cbStruct

Size, in bytes, of the ACMDRVFORMATSUGGEST structure.

fdwSuggest

Contains restriction flags that limit the possible destination formats. Can contain any combination of the following flags.

Flag	Meaning
ACM_FORMATSUGGESTF_ WFORMATTAG	The wFormatTag member of the WAVEFORMATEX structure pointed to by pwfxDst contains a format tag. The driver can only suggest a destination format that is associated with the specified format tag.
ACM_FORMATSUGGESTF_ NCHANNELS	The nChannels member of the WAVEFORMATEX structure pointed to by pwfxDst contains a channel value. The driver can only suggest a destination format whose channel value matches the specified value.
ACM_FORMATSUGGESTF_ NSAMPLESPERSEC	The nSamplesPerSec member of the WAVEFORMATEX structure pointed to by pwfxDst contains a sample rate. The driver can only suggest a destination format whose sample rate matches the specified rate.
ACM_FORMATSUGGESTF_ WBITSPERSAMPLE	The nBitsPerSample member of the WAVEFORMATEX structure pointed to by pwfxDst contains a sample size. The driver can only suggest a destination format whose sample size matches the specified size.

pwfxSrc

Pointer to a WAVEFORMATEX structure describing the source format.

cbwfxSrc

Size, in bytes, of the WAVEFORMATEX structure pointed to by pwfxSrc.

pwfxDst

Pointer to a WAVEFORMATEX structure to receive the suggested destination format description. If flags in the fdwSuggest member are set, corresponding members of this structure contain client-specified values. The driver should fill in all empty structure members.

cbwfxDst

Size, in bytes, of the WAVEFORMATEX structure pointed to by pwfxDst. The driver cannot return an extended WAVEFORMATEX structure (see the Comments section) that is larger than this size.

Comments

The WAVEFORMATEX structures specified for source or destination formats might be extended structures defined for particular formats. (For example, see IMAADPCMWAVEFORMAT in mmreg.h.) Check the structure’s wFormatTag member to determine the format type and hence the specific structure being passed.

For more information about format structures, see Defining Format Structures and Filter Structures.