ACMFILTERTAGENUMCB-Rückruffunktion (msacm.h)

  • Artikel

Die Funktion acmFilterTagEnumCallback gibt eine Rückruffunktion an, die mit der Funktion acmFilterTagEnum verwendet wird. Der Name der acmFilterTagEnumCallback-Funktion ist ein Platzhalter für einen anwendungsdefinierten Funktionsnamen.

Syntax

ACMFILTERTAGENUMCB Acmfiltertagenumcb;

BOOL Acmfiltertagenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Handle mit dem ACM-Treiberbezeichner.

paftd

Zeiger auf eine ACMFILTERTAGDETAILS-Struktur , die die Details des aufgezählten Filtertags enthält.

dwInstance

Anwendungsdefinierter Wert, der in acmFilterTagEnum angegeben ist.

fdwSupport

Treiberunterstützungsflags, die für die ACMDRIVERDETAILS-Struktur des Treiberbezeichners spezifisch sind. Dieser Parameter kann eine Kombination aus den folgenden Werten sein und gibt an, welche Vorgänge der Treiber mit dem Filtertag unterstützt.

Wert Bedeutung
ACMDRIVERDETAILS_SUPPORTF_ASYNC Der Treiber unterstützt asynchrone Konvertierungen mit dem angegebenen Filtertag.
ACMDRIVERDETAILS_SUPPORTF_CODEC Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags, während das angegebene Filtertag verwendet wird. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Filtertag unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags bei Verwendung des angegebenen Filtertags. Wenn ein Treiber beispielsweise die Neustempelung von WAVE_FORMAT_PCM mit dem angegebenen Filtertag unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_FILTER Der Treiber unterstützt einen Filter (Änderung der Daten ohne Ändern der Formatattribute). Wenn ein Treiber beispielsweise Volume- oder Echovorgänge auf WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE Der Treiber unterstützt die Hardwareeingabe, -ausgabe oder beides mit dem angegebenen Filtertag über ein Waveform-Audiogerät. Eine Anwendung sollte die acmMetrics-Funktion mit den ACM_METRIC_HARDWARE_WAVE_INPUT - und ACM_METRIC_HARDWARE_WAVE_OUTPUT Metrikindizes verwenden, um die Waveform-Audiogerätebezeichner abzurufen, die dem unterstützenden ACM-Treiber zugeordnet sind.

Rückgabewert

Die Rückruffunktion muss TRUE zurückgeben, um die Enumeration fortzusetzen, oder FALSE , um die Enumeration zu beenden.

Hinweise

Die Funktion acmFilterTagEnum gibt MMSYSERR_NOERROR (null) zurück, wenn keine Filtertags aufgelistet werden sollen. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.

Die folgenden Funktionen sollten nicht innerhalb der Rückruffunktion aufgerufen werden: acmDriverAdd, acmDriverRemove und acmDriverPriority.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile msacm.h

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager