acmDriverEnum-Funktion (msacm.h)
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 |
|---|---|
|
Mindestens ein Flag ist ungültig. |
|
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 |