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

Artikel
02/07/2025

Die IPrintOemDriverUI::DrvGetDriverSetting-Methode wird von den Unidrv- und Pscript5-Minidrivern bereitgestellt, damit Benutzeroberflächen-Plug-Ins den aktuellen Status von Druckerfeatures und anderen internen Informationen erhalten 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 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

Beim Aufrufen der IPrintOemDriverUI::DrvGetDriverSetting-Methode kann ein Benutzeroberflächen-Plug-In entweder einen Zeichenfolgenzeiger oder einen Konstantenwert für pFeatureKeyword-angeben.

Wenn pFeatureKeyword eine Zeichenfolge ist, muss sie eine der folgenden Werte darstellen:
- Ein Featurename, der in einer Unidrv minidriver GPD-Datei angegeben ist, oder,
- Ein Schlüsselwortargument für einen *OpenUI- Eintrag in der PPD-Datei eines Pscript5-Minidrivers.
Die Methode gibt eine oder mehrere NULL-beendete Zeichenfolgen im Puffer zurück, auf die durch pOutput-verwiesen wird. Jede Zeichenfolge stellt den Namen einer aktuell ausgewählten Option dar. Die Anzahl der Zeichenfolgen wird in pdwOptionsReturnedzurückgegeben.
Wenn pFeatureKeyword eine Konstante ist, muss es sich um eine der OEMGDS_-präfixierten Konstanten handeln, die in printoem.h definiert sind. Die Methode gibt den durch die angegebene Konstante angegebenen Wert zurück, indem er in den Puffer platziert wird, auf den pOutputverweist. Der in pdwOptionsReturned zurückgegebene Wert ist immer 1.

Anforderungen

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

Freigeben über