ACMFILTERENUMCB-Rückruffunktion (msacm.h)

  • Artikel

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

Syntax

ACMFILTERENUMCB Acmfilterenumcb;

BOOL Acmfilterenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILS pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Handle für den ACM-Treiberbezeichner.

pafd

Zeiger auf eine ACMFILTERDETAILS-Struktur , die die aufgezählten Filterdetails für ein Filtertag enthält.

dwInstance

Anwendungsdefinierter Wert, der in acmFilterEnum angegeben ist.

fdwSupport

Treiberunterstützungsflags, die spezifisch für den Treiber sind, der durch die ACMDRIVERDETAILS-Struktur identifiziert wird, aber sie sind spezifisch für den Filter, der aufgezählt wird. Dieser Parameter kann eine Kombination der folgenden Werte sein und identifiziert, welche Vorgänge der Treiber für das 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 der angegebene Filter verwendet wird. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM mit dem angegebenen Filter unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags, während der angegebene Filter verwendet wird. Wenn z. B. ein Treiber die Neusampling von WAVE_FORMAT_PCM mit dem angegebenen Filter 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 Filter über ein Waveform-Audio-Gerä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 acmFilterEnum-Funktion gibt MMSYSERR_NOERROR (null) zurück, wenn keine Filter 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