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

Die IPrintOemDriverUni::DrvGetGPDData-Methode wird vom Unidrv-Treiber bereitgestellt, sodass Rendering-Plug-Ins Daten abrufen können, die in der GPD--Datei eines Druckers definiert sind.

Syntax

HRESULT DrvGetGPDData(
  PDEVOBJ pdevobj,
  DWORD   dwType,
  PVOID   pInputData,
  PVOID   pBuffer,
  DWORD   cbSize,
  PDWORD  pcbNeeded
);

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ- Struktur.

dwType

Vom Aufrufer bereitgestelltes Flag, das den Typ der angeforderten GPD-Daten angibt. Derzeit ist das folgende Flag das einzige definiert:

Flagge	Definition
GPD_OEMCUSTOMDATA	Die Methode gibt die Zeichenfolge zurück, die dem *OEMCustomData Eintrag einer GPD-Datei zugeordnet ist.

pInputData

Reserviert. Muss null sein.

pBuffer

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um die angeforderten Informationen zu empfangen.

cbSize

Vom Aufrufer bereitgestellte Größe des Puffers in Byte, auf den pBuffer-verweist.

pcbNeeded

Empfängt die vom Treiber bereitgestellte Mindestpuffergröße in Bytes, die erforderlich ist, um die angeforderten Informationen zu enthalten.

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

Wenn der durch pBuffer angegebene Puffer und cbSize zu klein ist, um die angeforderten Informationen zu erhalten, stellt Unidrv die erforderliche Puffergröße an der Position bereit, auf die pcbNeedededverweist, gibt E_FAIL zurück und legt den Fehlercode auf ERROR_INSUFFICIENT_BUFFER fest.

Anforderungen

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