acmFilterTagEnum
The acmFilterTagEnum
function enumerates waveform-audio filter tags available from an ACM driver.
This function continues enumerating until there are no more suitable filter
tags or the callback function returns FALSE.
MMRESULT acmFilterTagEnum(
HACMDRIVER
had, |
|
LPACMFILTERTAGDETAILS paftd, |
|
ACMFILTERTAGENUMCB fnCallback, |
|
DWORD dwInstance, |
|
DWORD fdwEnum |
|
); |
|
Parameters
had
Handle of the
ACM driver to query for waveform-audio filter tag details. If this parameter is
NULL, the ACM uses the details from the first suitable ACM driver.
paftd
Address of
the ACMFILTERTAGDETAILS
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 filter 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