Método IPrintOemDriverUni::D rvGetGPDData (prcomoem.h)

El controlador Unidrv proporciona el método IPrintOemDriverUni::DrvGetGPDData para que los complementos de representación puedan obtener datos definidos en el archivo GPD de una impresora.

Sintaxis

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

Parámetros

pdevobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ.

dwType

Marca proporcionada por el autor de la llamada que indica el tipo de datos GPD que se solicitan. Actualmente, la marca siguiente es la única definida:

Bandera	Definición
GPD_OEMCUSTOMDATA	El método devuelve la cadena asociada a la entrada * de un archivo GPD *OEMCustomData.

pInputData

Reservado. Debe ser cero.

pBuffer

Puntero proporcionado por el autor de la llamada a un búfer para recibir la información solicitada.

cbSize

Tamaño proporcionado por el autor de la llamada, en bytes, del búfer al que apunta pBuffer.

pcbNeeded

Recibe el tamaño mínimo del búfer proporcionado por el controlador, en bytes, necesario para contener la información solicitada.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no se implementa.

Observaciones

Si el búfer especificado por pBuffer y cbSize es demasiado pequeño para recibir la información solicitada, Unidrv proporciona el tamaño de búfer necesario en la ubicación a la que apunta pcbNeeded, devuelve E_FAIL y establece el código de error en ERROR_INSUFFICIENT_BUFFER.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)