IPrintOemDriverPS::D rvGetDriverSetting-Methode (prcomoem.h)
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.
HRESULT DrvGetDriverSetting(
PVOID pdriverobj,
PCSTR Feature,
PVOID pOutput,
DWORD cbSize,
PDWORD pcbNeeded,
PDWORD pdwOptionsReturned
);
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.
Die -Methode muss einen der folgenden Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Fehler beim Vorgang |
|
Die Methode ist nicht implementiert. |
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.
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | prcomoem.h (include Prcomoem.h) |