DrvDriverEvent-Funktion (winddiui.h)

Artikel
02/07/2025

Der Druckspooler ruft die DrvDriverEvent--Funktion einer Druckerschnittstelle auf, wenn der Spooler treiberspezifische Ereignisse verarbeitet, die möglicherweise eine Aktion vom Druckertreiber erfordern.

Syntax

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

Parameter

dwDriverEvent

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

Flagge	Definition
DRIVER_EVENT_DELETE	Der Treiber wird entfernt.
DRIVER_EVENT_INITIALIZE	Der Treiber wurde soeben 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 von pDriverInfo-
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. Siehe den folgenden Abschnitt "Hinweise".

Rückgabewert

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

Bemerkungen

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

Der Zweck der Funktion besteht darin, den Druckerschnittstellen-DLL- eines Druckertreibers zu ermöglichen, Vorgänge auszuführen, die erforderlich sind, wenn der Treiber installiert oder entfernt wird. 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-Dateiangegeben sind.

Wenn dwDriverEvent- DRIVER_EVENT_DELETE ist, enthält der lparam--Parameter die Flags, die für den DeletePrinterDriverEx-Parameter der dwDeleteFlag-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
Header-	winddiui.h (include Winddiui.h)

Freigeben über