DriverCallback-Funktion (mmiscapi.h)

Artikel
08/24/2023

Ruft eine Rückruffunktion auf, sendet eine Nachricht an ein Fenster oder hebt die Blockierung eines Threads auf. Die Aktion hängt vom Wert des Benachrichtigungsflags ab. Diese Funktion soll nur innerhalb der DriverProc-Funktion eines installierbaren Treibers verwendet werden.

Syntax

BOOL DriverCallback(
  DWORD_PTR dwCallback,
  DWORD     dwFlags,
  HDRVR     hDevice,
  DWORD     dwMsg,
  DWORD_PTR dwUser,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Parameter

dwCallback

Adresse der Rückruffunktion, eines Fensterhandles oder eines Aufgabenhandles, je nach dem im dwFlags-Parameter angegebenen Flag.

dwFlags

Benachrichtigungsflags. Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
DCB_NOSWITCH	Das System wird daran gehindert, Stapel zu wechseln. Dieser Wert wird nur verwendet, wenn bekannt ist, dass genügend Stapelspeicherplatz für die Rückruffunktion vorhanden ist.
DCB_FUNCTION	Der dwCallback-Parameter ist die Adresse einer anwendungsdefinierten Rückruffunktion. Das System sendet die Rückrufnachricht an die Rückruffunktion.
DCB_WINDOW	Der dwCallback-Parameter ist das Handle eines anwendungsdefinierten Fensters. Das System sendet nachfolgende Benachrichtigungen an das Fenster.
DCB_TASK	Der dwCallback-Parameter ist das Handle einer Anwendung oder Aufgabe. Das System sendet nachfolgende Benachrichtigungen an die Anwendung oder Aufgabe.

hDevice

Handle des installierbaren Treibers instance.

dwMsg

Nachrichtenwert.

dwUser

32-Bit-Benutzer-instance Daten, die von der Anwendung beim Öffnen des Geräts bereitgestellt wurden.

dwParam1

32-Bit-nachrichtenabhängiger Parameter.

dwParam2

32-Bit-nachrichtenabhängiger Parameter.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich oder FALSE , wenn ein Parameter ungültig ist oder die Nachrichtenwarteschlange der Aufgabe voll ist.

Hinweise

Der Client gibt an, wie er benachrichtigt werden soll, wenn das Gerät geöffnet wird. Die flags DCB_FUNCTION und DCB_WINDOW entsprechen dem Wort mit hoher Ordnung der entsprechenden Flags CALLBACK_FUNCTION und CALLBACK_WINDOW, die im lParam2-Parameter der DRV_OPEN Meldung angegeben wurden, als das Gerät geöffnet wurde.

Wenn eine Benachrichtigung mit einer Rückruffunktion erfolgt, werden hdrvr, msg, dwUser, dwParam1 und dwParam2 an die Rückruffunktion übergeben. Wenn die Benachrichtigung über ein Fenster erfolgt, werden nur msg, hdrvr und dwParam1 an das Fenster übergeben.

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	mmiscapi.h (mmiscapi.h einschließen)
Bibliothek	Winmm.lib
DLL	Winmm.dll

Weitere Informationen

Treiberfunktionen

Installierbare Treiber

Freigeben über