Share via

acmDriverAddA-Funktion (msacm.h)

  • Artikel

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 acmDriverAddA(
  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 mit dem instance 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 flag ACM_DRIVERADDF_NOTIFYHWND verwendet. Für alle anderen Flags muss dieses Element auf 0 festgelegt werden.

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 Prototyp acmDriverProc entspricht. Die Funktion kann sich entweder in einer ausführbaren Datei oder in 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 ist. Weitere Informationen finden Sie unter Hinzufügen von Treibern innerhalb einer Anwendung.
ACM_DRIVERADDF_LOCAL Der ACM gibt einem lokalen Treiber automatisch höhere Priorität als einem globalen Treiber, wenn nach einem Treiber gesucht wird, um einen Funktionsaufruf zu erfüllen. Weitere Informationen finden Sie unter Hinzufügen von Treibern innerhalb 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 Nachrichten 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 können 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 der Vorgang erfolgreich war oder andernfalls ein Fehler. 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.

Hinweise

Hinweis

Der msacm.h-Header definiert acmDriverAdd als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
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