IPrintCoreUI2::D rvGetDriverSetting-Methode (prcomoem.h)

Artikel
02/26/2024

Die IPrintCoreUI2::DrvGetDriverSetting Methode wird vom Windows XP Pscript5-Treiber bereitgestellt, sodass Pscript5-Benutzeroberfläche-Plug-Ins die aktuelle status von Druckerfeatures und anderen internen Informationen abrufen können.

Syntax

HRESULT DrvGetDriverSetting(
  PVOID  pci,
  PCSTR  Feature,
  PVOID  pOutput,
  DWORD  cbSize,
  PDWORD pcbNeeded,
  PDWORD pdwOptionsReturned
);

Parameter

pci

Vom Aufrufer bereitgestellter Zeiger auf eine OEMUIOBJ-Struktur .

Feature

Vom Aufrufer bereitgestellter Wert, der das Druckerfeature identifiziert, für das Optionseinstellungen zurückgegeben werden. Dies kann entweder ein Zeichenfolgenzeiger oder eine Konstante sein, wie im folgenden Abschnitt Hinweise beschrieben.

pOutput

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um die angegebenen Informationen zu empfangen.

cbSize

Vom Aufrufer bereitgestellte Größe des Puffers, auf den pOutput verweist, in Bytes.

pcbNeeded

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, um die minimale Puffergröße zu erhalten, die erforderlich ist, um die angeforderten Informationen zu enthalten.

pdwOptionsReturned

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, an dem die Anzahl der In pOutput platzierten Optionszeichenfolgen empfangen wird.

Rückgabewert

Diese Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

Diese Methode wird von der IPrintOemDriverUI-COM-Schnittstelle geerbt und kann nur von Windows XP und höher Pscript5 UI-Plug-Ins aufgerufen werden, die die Standardoberflächenseiten des Kerntreibers nicht vollständig ersetzen, und wird während der IPrintOemUI::D ocumentPropertySheets und IPrintOemUI::D evicePropertySheets-Funktionen und deren Eigenschaftenblatt-Rückrufroutinen des UI-Plug-Ins unterstützt. Wenn diese Methode unterstützt wird, hat sie das gleiche Verhalten wie IPrintOemDriverUI::D rvGetDriverSetting. Wenn sie nicht unterstützt wird, sollte diese Methode E_NOTIMPL zurückgeben.