acmDriverAddW-Funktion (msacm.h)
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 acmDriverAddW(
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 |
---|---|
|
Mindestens ein Kennzeichen ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
|
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 |