acmDriverEnum-Funktion (msacm.h)

  • Artikel

Die Funktion acmDriverEnum listet die verfügbaren ACM-Treiber auf und setzt fort, bis keine treiber mehr vorhanden sind oder die Rückruffunktion FALSE zurückgibt.

Syntax

MMRESULT ACMAPI acmDriverEnum(
  ACMDRIVERENUMCB fnCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwEnum
);

Parameter

fnCallback

Prozedur instance Adresse der anwendungsdefinierte Rückruffunktion.

dwInstance

Ein anwendungsdefinierter 64-Bit- (DWORD_PTR) oder 32-Bit-Wert (DWORD), der zusammen mit ACM-Treiberinformationen an die Rückruffunktion übergeben wird.

fdwEnum

Flags zum Aufzählen von ACM-Treibern. Die folgenden Werte werden definiert.

Wert Bedeutung
ACM_DRIVERENUMF_DISABLED Deaktivierte ACM-Treiber sollten in der Enumeration enthalten sein. Treiber können vom Benutzer über die Systemsteuerung oder durch eine Anwendung mit der Funktion acmDriverPriority deaktiviert werden. Wenn ein Treiber deaktiviert ist, ist für den fdwSupport-Parameter für die Rückruffunktion das ACMDRIVERDETAILS_SUPPORTF_DISABLED-Flag festgelegt.
ACM_DRIVERENUMF_NOLOCAL Nur globale Treiber sollten in die Enumeration einbezogen werden.

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
MMSYSERR_INVALFLAG
 Mindestens ein Flag ist ungültig.
MMSYSERR_INVALPARAM
 Mindestens ein Parameter ist ungültig.

Hinweise

Die Funktion acmDriverEnum gibt MMSYSERR_NOERROR (null) zurück, wenn keine ACM-Treiber installiert sind. Darüber hinaus wird die Rückruffunktion nicht aufgerufen.

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
Bibliothek Msacm32.lib
DLL Msacm32.dll

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager