DRIVERPROC-Rückruffunktion (mmiscapi.h)

Artikel
08/24/2023

Verarbeitet Treibermeldungen für den installierbaren Treiber. DriverProc ist eine vom Treiber bereitgestellte Funktion.

Syntax

DRIVERPROC Driverproc;

LRESULT Driverproc(
  DWORD_PTR unnamedParam1,
  HDRVR unnamedParam2,
  UINT unnamedParam3,
  LPARAM unnamedParam4,
  LPARAM unnamedParam5
)
{...}

Parameter

unnamedParam1

Bezeichner des installierbaren Treibers.

unnamedParam2

Handle des installierbaren Treibers instance. Jede instance des installierbaren Treibers verfügt über ein eindeutiges Handle.

unnamedParam3

Treibermeldungswert. Es kann sich um einen benutzerdefinierten Wert oder um einen der folgenden Standardwerte handeln:

Wert	Bedeutung
DRV_CLOSE	Benachrichtigt den Treiber, dass er seine Nutzungsanzahl verringern und den Treiber entladen soll, wenn die Anzahl 0 ist.
DRV_CONFIGURE	Benachrichtigt den Treiber, dass ein Konfigurationsdialogfeld angezeigt werden soll. Diese Nachricht wird nur gesendet, wenn der Treiber beim Verarbeiten der DRV_QUERYCONFIGURE Nachricht einen wert ohne Zero zurückgibt.
DRV_DISABLE	Benachrichtigt den Treiber, dass der zugewiesene Arbeitsspeicher freigegeben werden soll.
DRV_ENABLE	Benachrichtigt den Treiber darüber, dass er geladen oder neu geladen wurde oder dass Windows aktiviert wurde.
DRV_FREE	Benachrichtigt den Treiber, dass er verworfen wird.
DRV_INSTALL	Benachrichtigt den Treiber, dass er erfolgreich installiert wurde.
DRV_LOAD	Benachrichtigt den Treiber, dass er erfolgreich geladen wurde.
DRV_OPEN	Benachrichtigt den Treiber, dass er geöffnet werden soll.
DRV_POWER	Benachrichtigt den Treiber darüber, dass die Energiequelle des Geräts ein- oder ausgeschaltet werden soll.
DRV_QUERYCONFIGURE	Weist den Treiber an, anzugeben, ob er die DRV_CONFIGURE Nachricht unterstützt.
DRV_REMOVE	Benachrichtigt den Treiber, dass er aus dem System entfernt werden soll.

unnamedParam4

32-Bit-nachrichtenspezifischer Wert.

unnamedParam5

32-Bit-nachrichtenspezifischer Wert.

Rückgabewert

Gibt nonzero zurück, wenn der Vorgang erfolgreich war oder andernfalls null.

Hinweise

Wenn msgDRV_OPEN ist, ist lParam1 die Zeichenfolge, die dem Treiberdateinamen aus der SYSTEM.INI-Datei folgt, und lParam2 ist der Wert, der als lParam-Parameter in einem Aufruf der OpenDriver-Funktion angegeben wird.

Wenn msgDRV_CLOSE ist, sind lParam1 und lParam2 dieselben Werte wie die Parameter lParam1 und lParam2 in einem Aufruf der CloseDriver-Funktion .

Anforderungen


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 (einschließlich Mmiscapi.h, Windows.h)

Weitere Informationen

Treiberfunktionen

Installierbare Treiber

Freigeben über