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

Artikel
03/01/2024

Die IPrintOemDriverUni::DrvGetDriverSetting Methode wird vom Unidrv-Treiber bereitgestellt, sodass 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 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

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 IPrintOemDriverUni::DrvGetDriverSetting Methode aufgerufen wird, kann entweder ein Zeichenfolgenzeiger oder ein konstanter Wert für pFeatureKeyword angegeben werden.

Wenn pFeatureKeyword eine Zeichenfolge ist, muss es einen Featurenamen darstellen, der in einer Unidrv-Minidriver-GPD-Datei angegeben ist.
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 von Zeichenfolgen sollte in pdwOptionsReturned zurückgegeben werden.
Wenn pFeatureKeyword eine Konstante ist, muss es sich um eine der OEMGDS_-Präfixkonstanten handeln, die in printoem.h definiert sind. Die -Methode sollte den von der angegebenen Konstante angegebenen Wert zurückgeben, indem sie ihn in den Puffer legt, auf den pOutput verweist. Der in pdwOptionsReturned zurückgegebene Wert muss 1 sein.

Anforderungen

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

Freigeben über