acmDriverAddA-Funktion (msacm.h)

Artikel
11/20/2024

Die acmDriverAdd--Funktion fügt der Liste der verfügbaren ACM-Treiber einen Treiber hinzu. Der Treibertyp und der Speicherort sind von den Flags abhängig, die zum Hinzufügen von ACM-Treibern verwendet werden. Nachdem ein Treiber erfolgreich hinzugefügt wurde, erhält die Treibereingabefunktion ACM-Treibermeldungen.

Syntax

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

Parameter

phadid

Zeigen Sie 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

Behandeln Sie die Instanz des Moduls, dessen ausführbare oder dynamic Link Library (DLL) die Treibereingabefunktion enthält.

lParam

Treiberfunktionsadresse 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 ACM_DRIVERADDF_NOTIFYHWND-Flag verwendet. Alle anderen Flags erfordern, dass dieses Element auf Null festgelegt ist.

fdwAdd

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

Wert	Bedeutung
ACM_DRIVERADDF_FUNCTION	Der lParam Parameter ist eine Treiberfunktionsadresse, die dem acmDriverProc Prototyp entspricht. Die Funktion kann sich entweder in einer ausführbaren datei oder dll-Datei befinden.
ACM_DRIVERADDF_GLOBAL	Für kompatibilität mit 16-Bit-Anwendungen bereitgestellt. Für die Win32-API können ACM-Treiber, die von der acmDriverAdd--Funktion hinzugefügt wurden, nur von der Anwendung verwendet werden, die den Treiber hinzugefügt hat. Dies gilt, ob ACM_DRIVERADDF_GLOBAL angegeben wird. Weitere Informationen finden Sie unter Hinzufügen von Treibern in einer Anwendung.
ACM_DRIVERADDF_LOCAL	Das ACM gibt einem lokalen Treiber automatisch eine höhere Priorität als ein globaler 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 parameter lParam 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 Kennzeichen 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 Nachrichten empfängt, wenn Änderungen an globalen Treiberprioritäten und -zuständen vorgenommen werden. Die empfangende Fensternachricht wird von der Anwendung definiert und muss in dwPriority-übergeben werden. Die wParam und lParam Parameter, die mit der Fensternachricht übergeben werden, sind für die zukünftige Verwendung reserviert und sollten ignoriert werden. ACM_DRIVERADDF_GLOBAL kann in Verbindung mit dieser Kennzeichnung nicht angegeben werden. Weitere Informationen zu Treiberprioritäten finden Sie in der Beschreibung für die acmDriverPriority--Funktion.

Rückgabewert

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

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

Bemerkungen

Anmerkung

Der msacm.h-Header definiert acmDriverAdd als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	msacm.h
Library	Msacm32.lib
DLL-	Msacm32.dll

Siehe auch

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager

Freigeben über