Skip to content

Latest commit

 

History

History
120 lines (96 loc) · 5.13 KB

nc-msacm-acmfiltertagenumcb.md

File metadata and controls

120 lines (96 loc) · 5.13 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NC:msacm.ACMFILTERTAGENUMCB
ACMFILTERTAGENUMCB (msacm.h)
The ACMFILTERTAGENUMCB callback function specifies a callback function used with the acmFilterTagEnum function.
ACMFILTERTAGENUMCB
ACMFILTERTAGENUMCB callback
ACMFILTERTAGENUMCBA
ACMFILTERTAGENUMCBW
_win32_acmFilterTagEnumCallback
acmFilterTagEnumCallback
acmFilterTagEnumCallback callback function [Windows Multimedia]
msacm/ACMFILTERTAGENUMCBA
msacm/ACMFILTERTAGENUMCBW
msacm/acmFilterTagEnumCallback
multimedia.acmfiltertagenumcallback
multimedia\acmfiltertagenumcallback.htm
Multimedia
63469be1-d657-4e95-9978-d31140ccd46f
08/02/2022
ACMFILTERTAGENUMCB, ACMFILTERTAGENUMCB callback, ACMFILTERTAGENUMCBA, ACMFILTERTAGENUMCBW, _win32_acmFilterTagEnumCallback, acmFilterTagEnumCallback, acmFilterTagEnumCallback callback function [Windows Multimedia], msacm/ACMFILTERTAGENUMCBA, msacm/ACMFILTERTAGENUMCBW, msacm/acmFilterTagEnumCallback, multimedia.acmfiltertagenumcallback
msacm.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Windows
19H1
ACMFILTERTAGENUMCB
msacm/ACMFILTERTAGENUMCB
c++
APIRef
kbSyntax
UserDefined
Msacm.h
acmFilterTagEnumCallback
ACMFILTERTAGENUMCBA
ACMFILTERTAGENUMCBW

ACMFILTERTAGENUMCB callback function

-description

The acmFilterTagEnumCallback function specifies a callback function used with the acmFilterTagEnum function. The acmFilterTagEnumCallback function name is a placeholder for an application-defined function name.

-parameters

-param hadid

Handle to the ACM driver identifier.

-param paftd

Pointer to an ACMFILTERTAGDETAILS structure that contains the enumerated filter tag details.

-param dwInstance

Application-defined value specified in acmFilterTagEnum.

-param fdwSupport

Driver-support flags specific to the driver identifier ACMDRIVERDETAILS structure. This parameter can be a combination of the following values and identifies which operations the driver supports with the filter tag.

Value Meaning
ACMDRIVERDETAILS_SUPPORTF_ASYNC Driver supports asynchronous conversions with the specified filter tag.
ACMDRIVERDETAILS_SUPPORTF_CODEC Driver supports conversion between two different format tags while using the specified filter tag. For example, if a driver supports compression from WAVE_FORMAT_PCM to WAVE_FORMAT_ADPCM with the specified filter tag, this flag is set.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER Driver supports conversion between two different formats of the same format tag while using the specified filter tag. For example, if a driver supports resampling of WAVE_FORMAT_PCM with the specified filter tag, this flag is set.
ACMDRIVERDETAILS_SUPPORTF_FILTER Driver supports a filter (modification of the data without changing any of the format attributes). For example, if a driver supports volume or echo operations on WAVE_FORMAT_PCM, this flag is set.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE Driver supports hardware input, output, or both with the specified filter tag through a waveform-audio device. An application should use the acmMetrics function with the ACM_METRIC_HARDWARE_WAVE_INPUT and ACM_METRIC_HARDWARE_WAVE_OUTPUT metric indices to get the waveform-audio device identifiers associated with the supporting ACM driver.

-returns

The callback function must return TRUE to continue enumeration or FALSE to stop enumeration.

-remarks

The acmFilterTagEnum function returns MMSYSERR_NOERROR (zero) if no filter tags are to be enumerated. Moreover, the callback function will not be called.

The following functions should not be called from within the callback function: acmDriverAdd, acmDriverRemove, and acmDriverPriority.

-see-also

Audio Compression Functions

Audio Compression Manager