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

Artikel
02/07/2025

Die IPrintOemDriverPS::DrvGetDriverSetting-Methode wird vom Pscript5-Treiber bereitgestellt, sodass Rendering-Plug-Ins den aktuellen Status von Druckerfeatures und anderen internen Informationen abrufen können.

Syntax

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

Parameter

pdriverobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ- Struktur.

Feature

Der vom Anrufer angegebene Wert, der die Druckerfunktion angibt, für die 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 in Byte, auf den pOutput-verweist.

pcbNeeded

Vom Aufrufer bereitgestellter Zeiger auf eine Position, um die mindeste Puffergröße zu erhalten, die erforderlich ist, um die angeforderten Informationen zu enthalten.

pdwOptionsReturned

Vom Aufrufer bereitgestellter Zeiger auf eine Position, um die Anzahl der Optionszeichenfolgen zu empfangen, die in pOutput-platziert werden.

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Vorgang war erfolgreich.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Bemerkungen

Wenn die IPrintOemDriverPS::DrvGetDriverSetting-Methode aufgerufen wird, kann entweder ein Zeichenfolgenzeiger oder ein Konstantenwert für pFeatureKeyword-angegeben werden.

Wenn pFeatureKeyword- eine Zeichenfolge ist, muss es ein Schlüsselwortargument für einen *OpenUI- Eintrag in der PPD-Datei eines Pscript5-Minidrivers darstellen.
Die Methode sollte eine oder mehrere NULL-beendete Zeichenfolgen im Puffer zurückgeben, auf die durch pOutput-verwiesen wird. Jede Zeichenfolge sollte den Namen einer aktuell ausgewählten Option darstellen. Die Anzahl der Zeichenfolgen sollte in pdwOptionsReturnedzurückgegeben werden.
Wenn pFeatureKeyword eine Konstante ist, muss es sich um eine der OEMGDS_-präfixierten Konstanten handeln, die in printoem.h definiert sind. Die Methode sollte den durch die angegebene Konstante angegebenen Wert zurückgeben, indem er in den Puffer platziert wird, auf den pOutput-verweist. Der in pdwOptionsReturned zurückgegebene Wert muss 1 sein.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	prcomoem.h (einschließlich Prcomoem.h)

Freigeben über