ACMDRIVERENUMCB-Rückruffunktion (msacm.h)

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

Syntax

ACMDRIVERENUMCB Acmdriverenumcb;

BOOL Acmdriverenumcb(
  HACMDRIVERID hadid,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

Parameter

hadid

Handle für einen ACM-Treiberbezeichner.

dwInstance

Anwendungsdefinierter Wert, der in acmDriverEnum angegeben ist.

fdwSupport

Treiberunterstützungsflags, die für den von der ACMDRIVERDETAILS-Struktur angegebenen Treiber spezifisch sind. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

Wert	Bedeutung
ACMDRIVERDETAILS_SUPPORTF_ASYNC	Der Treiber unterstützt asynchrone Konvertierungen.
ACMDRIVERDETAILS_SUPPORTF_CODEC	Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formattags. Wenn ein Treiber beispielsweise die Komprimierung von WAVE_FORMAT_PCM zu WAVE_FORMAT_ADPCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_CONVERTER	Der Treiber unterstützt die Konvertierung zwischen zwei verschiedenen Formaten desselben Formattags. Wenn z. B. ein Treiber das ErneutesAmpling von WAVE_FORMAT_PCM unterstützt, wird dieses Flag festgelegt.
ACMDRIVERDETAILS_SUPPORTF_DISABLED	Der Treiber wurde deaktiviert. Eine Anwendung muss das ACM_DRIVERENUMF_DISABLED-Flag mit acmDriverEnum angeben, um deaktivierte Treiber in die Enumeration einzuschließen.
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.

Rückgabewert

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

Hinweise

Die acmDriverEnum-Funktion gibt MMSYSERR_NOERROR (null) zurück, wenn keine ACM-Treiber installiert sind. 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

Anforderung	Wert
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