|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 message requests an ACM driver to return information about a format tag.
|ACM_FORMATTAGDETAILSF_INDEX||Indicates that the
ACMFORMATTAGDETAILScontains a format tag index. The valid
index range is from 0 through 1 less than the
cFormatTagsmember returned in the driver's
The driver should return details for the format tag associated with the index.
|ACM_FORMATTAGDETAILSF_FORMATTAG||Indicates that the
ACMFORMATTAGDETAILScontains a format tag.
The driver returns details for the specified format tag.
|ACM_FORMATTAGDETAILSF_LARGESTSIZE||Indicates that the driver should return details for the format tag that has the largest format. The dwFormatTagmember of ACMFORMATTAGDETAILScan contain a format tag or WAVE_FORMAT_UNKNOWN.|
MMSYSERR_NOERROR indicates success. Otherwise, the driver returns one of the MMSYSERR error values declared in the Mmsystem.h header file or one of the ACMERR error values declared in the Msacm.h header file. The following are possible error values.
The ACM (Waveapi.dll) sends this message by calling the ACM driver's ACM_IOControlentry point through the DeviceIoControlfunction. The ACM sends this message when an application calls the acmFormatTagDetailsfunction.
All ACM drivers must support this message.
The client specifies the format tag in the dwFormatTagmember of ACMFORMATTAGDETAILS. The driver returns the following information for a particular tag:
Before calling the driver's ACM_IOControlfunction, the ACM verifies the following conditions:
If the format tag is WAVE_FORMAT_PCM, the driver return a 0-length string in szFormatTag. The ACM provides a description string for this format.
Before returning, the driver must set the cbStructmember of ACMFORMATTAGDETAILSto the actual number of bytes returned. The value returned in cbStructmust not be greater than the value received.
For more information about format tags and filter tags, see the Windows NT DDK.
|Runs on||Versions||Defined in||Include||Link to|
|Windows CE OS||1.0 and later|
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