DrvDriverEvent-Funktion (winddiui.h)

  • Artikel

Der Druckspooler ruft die DrvDriverEvent-Funktion einer Druckerschnittstellen-DLL auf, wenn der Spooler treiberspezifische Ereignisse verarbeitet, die möglicherweise eine Aktion des Druckertreibers erfordern.

Syntax

BOOL DrvDriverEvent(
                 DWORD  dwDriverEvent,
                 DWORD  dwLevel,
  [in, optional] LPBYTE pDriverInfo,
                 LPARAM lParam
);

Parameter

dwDriverEvent

Vom Aufrufer bereitgestelltes Bitflag, das das aufgetretene Ereignis angibt. Gültige Flags sind in der folgenden Tabelle aufgeführt.

Flag Definition
DRIVER_EVENT_DELETE Der Treiber wird entfernt.
DRIVER_EVENT_INITIALIZE Der Treiber wurde gerade installiert.

dwLevel

Vom Aufrufer bereitgestellter Wert, der den Typ der Struktur angibt, auf die der pDriverInfo-Parameter verweist, wie in der folgenden Tabelle angegeben.

dwLevel Wert Struktur, auf die von pDriverInfo verwiesen wird
1 DRIVER_INFO_1
2 DRIVER_INFO_2
3 DRIVER_INFO_3

Die DRIVER_INFO_N-Strukturen werden in der Microsoft Windows SDK-Dokumentation beschrieben.

[in, optional] pDriverInfo

Vom Aufrufer bereitgestellter Zeiger auf eine Struktur, deren Typ durch den dwLevel-Parameter identifiziert wird.

lParam

Vom Aufrufer bereitgestellte Flags. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte false zurückgegeben werden.

Hinweise

Die optionale DrvDriverEvent-Funktion wird von den Funktionen AddPrinterDriverEx und DeletePrinterDriverEx des Spoolers aufgerufen, die in der Windows SDK-Dokumentation beschrieben werden.

Der Zweck der Funktion besteht darin, der Druckerschnittstellen-DLL eines Druckertreibers die Ausführung von Vorgängen zu ermöglichen, die beim Installieren oder Entfernen des Treibers erforderlich sind. Ein typischer Vorgang für diese Funktion besteht darin, zusätzliche treiberspezifische Dateien zu erstellen oder zu entfernen, die nicht als abhängige Dateien in einer Drucker-INF-Datei angegeben werden.

Wenn dwDriverEvent DRIVER_EVENT_DELETE ist, enthält der lparam-Parameter die Flags, die für den dwDeleteFlag-Parameter der DeletePrinterDriverEx-Funktion angegeben wurden. Der lparam-Parameter wird nicht verwendet, wenn dwDriverEvent DRIVER_EVENT_INITIALIZE ist.

Da die DrvDriverEvent-Funktion im Kontext des Druckspoolers aufgerufen wird, kann keine Benutzeroberfläche angezeigt werden.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddiui.h (include Winddiui.h)