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