DrvDevicePropertySheets-Funktion (winddiui.h)
Die DrvDevicePropertySheets-Funktion einer Druckerschnittstellen-DLL ist für das Erstellen von Eigenschaftenblattseiten verantwortlich, die die Eigenschaften eines Druckers beschreiben.
Syntax
LONG DrvDevicePropertySheets(
[in, optional] PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parameter
[in, optional] pPSUIInfo
Vom Aufrufer bereitgestellter Zeiger auf eine PROPSHEETUI_INFO-Struktur .
lParam
Vom Aufrufer bereitgestellter ganzzahliger Wert, der vom Inhalt des Reason-Elements der PROPSHEETUI_INFO-Struktur abhängt, wie in der folgenden Tabelle aufgeführt.
| Reason-Wert | Definition von lParam |
|---|---|
| PROPSHEETUI_REASON_INIT | Zeiger auf eine DEVICEPROPERTYHEADER-Struktur . |
| Alle anderen Grundwerte | Weitere Informationen finden Sie in der Beschreibung des lParam-Parameters für den PFNPROPSHEETUI-Funktionstyp . (Die Adresse der DEVICEPROPERTYHEADER-Struktur ist im lParamInit-Element der PROPSHEETUI_INFO-Struktur enthalten.) |
Rückgabewert
Weitere Informationen finden Sie im Abschnitt ReturnValue in der Beschreibung des PFNPROPSHEETUI-Funktionstyps .
Hinweise
Alle Druckerschnittstellen-DLLs müssen eine DrvDevicePropertySheets-Funktion bereitstellen, die mithilfe des PFNPROPSHEETUI-Funktionstyps definiert wird. Der Zweck der Funktion besteht darin, die von CPSUI bereitgestellte ComPropSheet-Funktion aufzurufen, um eine Eigenschaftenblattseite anzugeben, die vom Benutzer änderbare Eigenschaften für den Drucker enthält.
Die Funktion sollte Vorgänge ausführen, wie für den Funktionstyp PFNPROPSHEETUI beschrieben. Die Funktion sollte die DeviceSettings-Eigenschaftenblattseite des Druckers erstellen (siehe das pDlgPage-Element der COMPROPSHEETUI-Struktur ).
Druckergeräteeinstellungen sollten in der Registrierung gespeichert werden. Wenn ein Benutzer mit Administratorrechten Optionen auf der Seite DeviceSettings ändert, sollte die DrvDevicePropertySheets-Funktion die aktualisierten Werte durch Aufrufen von SetPrinterData in die Registrierung schreiben (siehe Microsoft Windows SDK Dokumentation).
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winddiui.h (einschließlich Winddiui.h) |