IPrintOemUI::D evicePropertySheets-Methode (prcomoem.h)

Mit der IPrintOemUI::DevicePropertySheets-Methode kann ein Benutzeroberflächen-Plug-In eine neue Seite an das Druckereigenschaftenblatt eines Druckergeräts anfü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-->Reasonabhä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 lParam Parameterbeschreibung im PFNPROPSHEETUI- Funktionstyp.

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 PROPSHEETUI_INFO Reason Members der Struktur ab. Weitere Informationen finden Sie in der Beschreibung von DrvDevicePropertySheets.

Bemerkungen

Die IPrintOemUI::DevicePropertySheets-Methode eines Benutzeroberflächen-Plug-Ins führt dieselben Arten von Vorgängen wie die DrvDevicePropertySheets Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Beide Funktionen haben dieselben 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- Mitglied der PROPSHEETUI_INFO-Struktur die Adresse einer OEMUIPSPARAM- Struktur.

Wenn Sie diese Methode implementieren, geben Sie in der Regel auch eine _CPSUICALLBACK-typed callback function to handle user modifications an. Diese Rückruffunktion muss IPrintOemDriverUI::D rvUpdateUISetting aufrufen, um den Treiber darüber zu informieren, wenn der mit einer Benutzeroberflächeneinstellung verknüpfte 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 ist.

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 Plug-In für die Benutzeroberfläche mehrere Druckermodelle unterstützt und die neue Seite nur für einige dieser Modelle angezeigt werden soll, sollte die methode IPrintOemUI::DevicePropertySheets nur einen Erfolgsrücklaufwert bereitstellen, ohne die Seite tatsächlich hinzuzufügen, für die Modelle, die die Seite nicht erfordern.

Weitere Informationen zum Erstellen und Installieren von Plug-Ins für die Benutzeroberfläche finden Sie unter Anpassen der Druckertreiber von Microsoft.

Anforderungen

Siehe auch

DrvDevicePropertySheets

IPrintOemUI-

IPrintOemUI::D ocumentPropertySheets

PFNPROPSHEETUI-