acmFormatTagEnum
The acmFormatTagEnum
function enumerates waveform-audio format tags available from an ACM driver.
This function continues enumerating until there are no more suitable format
tags or the callback function returns FALSE.
MMRESULT acmFormatTagEnum(
|
HACMDRIVER
had, |
|
|
LPACMFORMATTAGDETAILS paftd, |
|
|
ACMFORMATTAGENUMCB fnCallback, |
|
|
DWORD dwInstance, |
|
|
DWORD fdwEnum |
|
|
); |
|
Parameters
had
Handle of the
ACM driver to query for waveform-audio format tag details. If this parameter is
NULL, the ACM uses the details from the first suitable ACM driver.
paftd
Address of
the ACMFORMATTAGDETAILS
structure that is to receive the format tag details passed to the function
specified in fnCallback. This structure must have the cbStruct
member of the ACMFORMATTAGDETAILS structure initialized.
fnCallback
Procedure
instance address of the application-defined callback function.
dwInstance
A 32-bit application-defined
value that is passed to the callback function along with ACM format tag
details.
fdwEnum
Reserved;
must be zero.
Return Values
Returns zero
if successful or an error otherwise. Possible error values include the
following:
|
MMSYSERR_INVALFLAG |
At least
one flag is invalid. |
|
MMSYSERR_INVALHANDLE |
The
specified handle is invalid. |
|
MMSYSERR_INVALPARAM |
At least
one parameter is invalid. |
Remarks
This function
will return MMSYSERR_NOERROR (zero) if no suitable ACM drivers are installed.
Moreover, the callback function will not be called.
See Also