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

Artikel
02/26/2024

Die IPrintOemDriverUI::DrvGetDriverSetting -Methode wird von den Unidrv- und Pscript5-Minitreibern bereitgestellt, damit Benutzeroberflächen-Plug-Ins die aktuelle status der Druckerfeatures und anderer interner 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 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, 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

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

Wenn pFeatureKeyword eine Zeichenfolge ist, muss es eine der folgenden Aussagen darstellen:
- Ein Featurename, der in einer Unidrv-Minitreiber-GPD-Datei angegeben ist, oder
- Ein Schlüsselwort (keyword) Argument für einen *OpenUI-Eintrag in der PPD-Datei eines Pscript5-Minitreibers.
Die -Methode gibt eine oder mehrere NULL-beendete Zeichenfolgen im Puffer zurück, auf den pOutput verweist. Jede Zeichenfolge stellt den Namen einer derzeit ausgewählten Option dar. Die Anzahl der Zeichenfolgen wird in pdwOptionsReturned zurückgegeben.
Wenn pFeatureKeyword eine Konstante ist, muss es sich um eine der in printoem.h definierten OEMGDS_-Präfixkonstanten handeln. Die -Methode gibt den wert zurück, der durch die angegebene Konstante angegeben wird, indem sie ihn im Puffer platziert, auf den pOutput verweist. Der in pdwOptionsReturned zurückgegebene Wert ist immer 1.

Anforderungen

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

Freigeben über