DRIVERPROC-Rückruffunktion (mmiscapi.h)

  • Artikel

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