IPrintOemUI::D evicePropertySheets-Methode (prcomoem.h)
Die IPrintOemUI::DevicePropertySheets -Methode ermöglicht es einem Benutzeroberflächen-Plug-In, eine neue Seite an das Druckereigenschaftenblatt eines Druckergeräts anzufügen.
Syntax
HRESULT DevicePropertySheets(
PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parameter
pPSUIInfo
Vom Aufrufer bereitgestellter Zeiger auf eine PROPSHEETUI_INFO-Struktur .
lParam
Vom Aufrufer bereitgestellter Wert, der vom Grundwert in pPSUIInfo--Reason> abhängt. Der Grundwert kann eine der folgenden Konstanten sein, die in compstui.h definiert sind. Weitere Informationen zu diesen Konstanten finden Sie im Abschnitt Hinweise und im Abschnitt lParam-Parameterbeschreibung im Funktionstyp PFNPROPSHEETUI .
PROPSHEETUI_REASON_DESTROY
PROPSHEETUI_REASON_GET_ICON
PROPSHEETUI_REASON_GET_INFO_HEADER
PROPSHEETUI_REASON_INIT
PROPSHEETUI_REASON_SET_RESULT
Rückgabewert
Der Rückgabewert hängt vom Inhalt des Reason-Elements PROPSHEETUI_INFO Struktur ab. Weitere Informationen finden Sie in der Beschreibung von DrvDevicePropertySheets.
Hinweise
Die Methode eines Benutzeroberflächen-Plug-Ins IPrintOemUI::DevicePropertySheets führt dieselben Arten von Vorgängen wie die DrvDevicePropertySheets-Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Beide Funktionen verfügen über die gleichen Eingabeparameter.
Wenn Sie ein Benutzeroberflächen-Plug-In bereitstellen, wird die IPrintOemUI::DevicePropertySheets -Methode aufgerufen, nachdem die DrvDevicePropertySheets-Funktion des Treibers aufgerufen wurde.
Wenn IPrintOemUI::DevicePropertySheets aufgerufen wird, enthält das lParamInit-Element der PROPSHEETUI_INFO-Struktur die Adresse einer OEMUIPSPARAM-Struktur .
Wenn Sie diese Methode implementieren, stellen Sie in der Regel auch eine _CPSUICALLBACK typisierte Rückruffunktion bereit, um Benutzeränderungen zu verarbeiten. Diese Rückruffunktion muss IPrintOemDriverUI::D rvUpdateUISetting aufrufen, um den Treiber darüber zu informieren, wenn der einer Benutzeroberflächeneinstellung zugeordnete Wert geändert wurde, wenn der Wert in der DEVMODEW-Struktur des Treibers (anstelle der privaten DEVMODEW-Member des Plug-Ins) oder in Registrierungsschlüsseln gespeichert wird.
Wenn IPrintOemUI::DevicePropertySheets Methoden von mehreren Benutzeroberflächen-Plug-Ins exportiert werden, werden die Methoden in der Reihenfolge aufgerufen, in der die Plug-Ins für die Installation angegeben werden.
Wenn ein Benutzeroberflächen-Plug-In mehrere Druckermodelle unterstützt und Sie möchten, dass die neue Seite nur für einige dieser Modelle angezeigt wird, sollte die IPrintOemUI::DevicePropertySheets Methode nur einen Erfolgsrückgabewert bereitstellen, ohne die Seite tatsächlich hinzuzufügen, für die Modelle, die die Seite nicht benötigen.
Weitere Informationen zum Erstellen und Installieren von Benutzeroberflächen-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (include Prcomoem.h) |