acmDriverMessage-Funktion (msacm.h)

  • Artikel

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
MMSYSERR_INVALHANDLE
 Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM
 Der uMsg-Parameter befindet sich nicht im ACMDM_USER Bereich.
MMSYSERR_NOTSUPPORTED
 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

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager