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

Artikel
02/26/2024

Die IPrintOemDriverPS::DrvGetDriverSetting -Methode wird vom Pscript5-Treiber bereitgestellt, damit Rendering-Plug-Ins die aktuelle status der Druckerfeatures und anderer interner 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 Aufrufer angegebene Wert, der die Druckerfunktion identifiziert, 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, auf den pOutput verweist, in Bytes.

pcbNeeded

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

pdwOptionsReturned

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort zum Empfangen der Anzahl von Optionszeichenfolgen, die in pOutput platziert sind.

Rückgabewert

Die -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

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

Wenn pFeatureKeyword eine Zeichenfolge ist, muss es ein Schlüsselwort (keyword) Argument für einen *OpenUI-Eintrag in der PPD-Datei eines Pscript5-Minitreibers darstellen.
Die -Methode sollte eine oder mehrere NULL-beendete Zeichenfolgen im Puffer zurückgeben, auf den pOutput verweist. Jede Zeichenfolge sollte den Namen einer aktuell ausgewählten Option darstellen. Die Anzahl der Zeichenfolgen, die in pdwOptionsReturned zurückgegeben werden soll.
Wenn pFeatureKeyword eine Konstante ist, muss es sich um eine der in printoem.h definierten OEMGDS_-Präfixkonstanten handeln. Die -Methode sollte den von der angegebenen Konstanten angegebenen Wert zurückgeben, indem sie ihn in den Puffer platziert, auf den pOutput verweist. Der in pdwOptionsReturned zurückgegebene Wert muss 1 sein.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (include Prcomoem.h)

Freigeben über