 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure contains client-specified input arguments to the AcmFormatSuggestfunction. 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.
typedef struct {
DWORD
cbStruct
;
DWORD
fdwSuggest
;
LPWAVEFORMATEX
pwfxSrc
;
DWORD
cbwfxSrc
;
LPWAVEFORMATEX
pwfxDst
;
DWORD
cbwfxDst
;
} ACMDRVFORMATSUGGEST;
Members
- cbStruct
- Specifies the size, in bytes, of the ACMDRVFORMATSUGGESTstructure.
- fdwSuggest
- Contains restriction flags that limit the possible destination
formats; any combination of the following flags:
Value Description ACM_FORMATSUGGESTF_WFORMATTAG The wFormatTagmember of the WAVEFORMATEXstructure pointed to by pwfxDstcontains a format tag. The driver can only suggest a destination format associated with the specified format tag; it cannot enforce the suggested format. ACM_FORMATSUGGESTF_NCHANNELS The nChannelsmember of the WAVEFORMATEXstructure pointed to by pwfxDstcontains a channel value. The driver can only suggest a destination format whose channel value matches the specified value; it cannot enforce the suggested format. ACM_FORMATSUGGESTF_NSAMPLESPERSEC The nSamplesPerSecmember of the WAVEFORMATEXstructure pointed to by pwfxDstcontains a sample rate. The driver can only suggest a destination format whose sample rate matches the specified rate; it cannot enforce the suggested format. ACM_FORMATSUGGESTF_WBITSPERSAMPLE The nBitsPerSamplemember of the WAVEFORMATEXstructure pointed to by pwfxDstcontains a sample size. The driver can only suggest a destination format whose sample size matches the specified size; it cannot enforce the suggested format. - pwfxSrc
- Pointer to a WAVEFORMATEXstructure describing the source format.
- cbwfxSrc
- Specifies the size, in bytes, of the WAVEFORMATEXstructure pointed to by pwfxSrc.
- pwfxDst
- Pointer to a WAVEFORMATEXstructure to receive the suggested destination format description. If flags in the fdwSuggestmember are set, corresponding members of this structure contain client-specified values. The driver should fill in all empty structure members.
- cbwfxDst
- Specifies the size, in bytes, of the
WAVEFORMATEXstructure pointed to by
pwfxDst. The driver cannot return an extended
WAVEFORMATEXstructure that is larger than this size.
Remarks
The WAVEFORMATEXstructures specified for source or destination formats might be extended structures defined for particular formats. For example, see IMAADPCMWAVEFORMATin the Mmreg.h header file. Check the structure's wFormatTagmember to determine the format type and, therefore, the specific structure being passed.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Msacmdrv.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004