acmDriverMessage-Funktion (msacm.h)
Die Funktion acmDriverMessage sendet eine benutzerdefinierte Nachricht an einen bestimmten ACM-Treiber instance.
Syntax
LRESULT ACMAPI acmDriverMessage(
HACMDRIVER had,
UINT uMsg,
LPARAM lParam1,
LPARAM lParam2
);
Parameter
had
Verarbeiten Sie den ACM-Treiber instance, an den die Nachricht gesendet wird.
uMsg
Meldung, die der ACM-Treiber verarbeiten muss. Diese Nachricht muss sich im ACMDM_USER Nachrichtenbereich (höher oder gleich ACMDM_USER und kleiner als ACMDM_RESERVED_LOW) sein. Ausnahmen von dieser Einschränkung sind die ACMDM_DRIVER_ABOUT-, DRV_QUERYCONFIGURE- und DRV_CONFIGURE-Nachrichten .
lParam1
Nachrichtenparameter.
lParam2
Nachrichtenparameter.
Rückgabewert
Der Rückgabewert ist spezifisch für die benutzerdefinierte ACM-Treibernachricht, die durch den uMsg-Parameter angegeben wird. Mögliche Fehlerwerte sind jedoch Folgendes.
| Rückgabecode | Beschreibung |
|---|---|
|
Das angegebene Handle ist ungültig. |
|
Der uMsg-Parameter befindet sich nicht im ACMDM_USER Bereich. |
|
Der ACM-Treiber hat die Nachricht nicht verarbeitet. |
Hinweise
Um ein benutzerdefiniertes Info-Dialogfeld aus einem ACM-Treiber anzuzeigen, muss eine Anwendung die ACMDM_DRIVER_ABOUT Nachricht an den Treiber senden. Der Parameter lParam1 sollte das Handle des Besitzerfensters für das benutzerdefinierte Info-Dialogfeld sein, und lParam2 muss auf 0 festgelegt werden. Wenn der Treiber kein benutzerdefiniertes Info-Dialogfeld unterstützt, wird MMSYSERR_NOTSUPPORTED zurückgegeben, und es liegt in der Verantwortung der Anwendung, ein eigenes Dialogfeld anzuzeigen. Beispielsweise zeigt die Option Systemsteuerung Sound Mapper ein Standarddialogfeld Info basierend auf der ACMDRIVERDETAILS-Struktur an, wenn ein ACM-Treiber MMSYSERR_NOTSUPPORTED zurückgibt. Eine Anwendung kann einen Treiber für die Unterstützung benutzerdefinierter Info-Dialogfelder abfragen, ohne dass das Dialogfeld angezeigt wird, indem lParam1 auf –1L festgelegt wird. Wenn der Treiber ein benutzerdefiniertes Info-Dialogfeld unterstützt, wird MMSYSERR_NOERROR zurückgegeben. Andernfalls wird der Rückgabewert MMSYSERR_NOTSUPPORTED.
Benutzerdefinierte Nachrichten dürfen nur an einen ACM-Treiber gesendet werden, der die Nachrichten speziell unterstützt. Der Aufrufer sollte überprüfen, ob der ACM-Treiber der richtige Treiber ist, indem er die Treiberdetails abruft und die wMid-, wPid- und vdwDriver-Member der ACMDRIVERDETAILS-Struktur überprüft.
Senden Sie nie benutzerdefinierte Nachrichten an einen unbekannten ACM-Treiber.
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 |