acmDriverAdd-Funktion (msacm.h)

Artikel
08/24/2023

Die acmDriverAdd-Funktion fügt der Liste der verfügbaren ACM-Treiber einen Treiber hinzu. Der Treibertyp und der Speicherort hängen von den Flags ab, die zum Hinzufügen von ACM-Treibern verwendet werden. Nachdem ein Treiber erfolgreich hinzugefügt wurde, empfängt die Treibereingabefunktion ACM-Treibermeldungen.

Syntax

MMRESULT ACMAPI acmDriverAdd(
  LPHACMDRIVERID phadid,
  HINSTANCE      hinstModule,
  LPARAM         lParam,
  DWORD          dwPriority,
  DWORD          fdwAdd
);

Parameter

phadid

Zeiger auf den Puffer, der ein Handle empfängt, das den installierten Treiber identifiziert. Dieses Handle wird verwendet, um den Treiber in Aufrufen anderer ACM-Funktionen zu identifizieren.

hinstModule

Handle für die instance des Moduls, dessen ausführbare Datei oder DLL (Dynamic Link Library) die Treibereingabefunktion enthält.

lParam

Die Adresse der Treiberfunktion oder ein Benachrichtigungsfensterhandle, abhängig von den fdwAdd-Flags .

dwPriority

Fensternachricht, die für Benachrichtigungsübertragungen gesendet werden soll. Dieser Parameter wird nur mit dem flag ACM_DRIVERADDF_NOTIFYHWND verwendet. Alle anderen Flags erfordern, dass dieses Element auf 0 (null) festgelegt ist.

fdwAdd

Flags zum Hinzufügen von ACM-Treibern. Die folgenden Werte werden definiert.

Wert	Bedeutung
ACM_DRIVERADDF_FUNCTION	Der lParam-Parameter ist eine Treiberfunktionsadresse, die dem acmDriverProc-Prototyp entspricht. Die Funktion kann sich in einer ausführbaren Datei oder einer DLL-Datei befinden.
ACM_DRIVERADDF_GLOBAL	Wird für die Kompatibilität mit 16-Bit-Anwendungen bereitgestellt. Für die Win32-API können ACM-Treiber, die von der Funktion acmDriverAdd hinzugefügt wurden, nur von der Anwendung verwendet werden, die den Treiber hinzugefügt hat. Dies gilt unabhängig davon, ob ACM_DRIVERADDF_GLOBAL angegeben wird. Weitere Informationen finden Sie unter Hinzufügen von Treibern in einer Anwendung.
ACM_DRIVERADDF_LOCAL	Der ACM gibt einem lokalen Treiber automatisch eine höhere Priorität als einem globalen Treiber, wenn er nach einem Treiber sucht, um einen Funktionsaufruf zu erfüllen. Weitere Informationen finden Sie unter Hinzufügen von Treibern in einer Anwendung.
ACM_DRIVERADDF_NAME	Der lParam-Parameter ist ein Registrierungswertname in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Drivers32. Der Wert identifiziert eine DLL, die einen ACM-Codec implementiert. Anwendungen können dieses Flag verwenden, wenn neue Registrierungseinträge erstellt werden, nachdem die Anwendung bereits mit der Verwendung des ACM begonnen hat.
ACM_DRIVERADDF_NOTIFYHWND	Der lParam-Parameter ist ein Handle eines Benachrichtigungsfensters, das Meldungen empfängt, wenn Änderungen an globalen Treiberprioritäten und -zuständen vorgenommen werden. Die zu empfangende Fensternachricht wird von der Anwendung definiert und muss in dwPriority übergeben werden. Die parameter wParam und lParam , die mit der Fenstermeldung übergeben werden, sind für die zukünftige Verwendung reserviert und sollten ignoriert werden. ACM_DRIVERADDF_GLOBAL kann nicht in Verbindung mit diesem Flag angegeben werden. Weitere Informationen zu Treiberprioritäten finden Sie in der Beschreibung der Funktion acmDriverPriority .

Rückgabewert

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

Rückgabecode	Beschreibung
MMSYSERR_INVALFLAG	Mindestens ein Flag ist ungültig.
MMSYSERR_INVALPARAM	Mindestens ein Parameter ist ungültig.
MMSYSERR_NOMEM	Das System kann keine Ressourcen zuordnen.

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