ACMFILTERTAGENUMCBW-Rückruffunktion (msacm.h)

  • Artikel

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

Syntax

ACMFILTERTAGENUMCBW Acmfiltertagenumcbw;

BOOL Acmfiltertagenumcbw(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILSW paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Handle für den 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 der folgenden Werte sein und identifiziert, 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, während das angegebene Filtertag verwendet wird. Wenn z. B. ein Treiber das ErneutesAmpling 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 Änderung der Formatattribute). Wenn ein Treiber beispielsweise Volume- oder Echovorgänge für WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_HARDWARE Der Treiber unterstützt Hardwareeingaben, -ausgaben 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 dem unterstützenden ACM-Treiber zugeordneten Waveform-Audio-Gerätebezeichner abzurufen.

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.

Hinweis

Der msacm.h-Header definiert ACMFILTERTAGENUMCB als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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