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

  • Artikel

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 nur das folgende Flag definiert:

Flag 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, auf den pBuffer verweist, in Bytes.

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 wurde erfolgreich ausgeführt.
E_FAIL
 Fehler beim Vorgang.
E_NOTIMPL
 Die Methode ist nicht implementiert.

Hinweise

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

Anforderungen

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