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

Artikel
02/29/2024

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)

Freigeben über