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

Artigo
02/07/2025

O método IPrintOemDriverUni::DrvGetGPDData é fornecido pelo driver Unidrv para que os plug-ins de renderização possam obter dados definidos no arquivo GPD de uma impressora.

Sintaxe

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

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura de DEVOBJ.

dwType

Sinalizador fornecido pelo chamador indicando o tipo de dados GPD que estão sendo solicitados. Atualmente, o seguinte sinalizador é o único definido:

Bandeira	Definição
GPD_OEMCUSTOMDATA	O método retorna a cadeia de caracteres associada à entrada de* de um arquivo GPD * OEMCustomData.

pInputData

Reservado. Deve ser zero.

pBuffer

Ponteiro fornecido pelo chamador para um buffer para receber as informações solicitadas.

cbSize

Tamanho fornecido pelo chamador, em bytes, do buffer apontado por pBuffer.

pcbNeeded

Recebe o tamanho mínimo do buffer fornecido pelo driver, em bytes, necessário para conter as informações solicitadas.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

Se o buffer especificado por pBuffer e cbSize for muito pequeno para receber as informações solicitadas, a Unidrv fornecerá o tamanho do buffer necessário no local apontado por pcbNeeded, retornará E_FAIL e definirá o código de erro como ERROR_INSUFFICIENT_BUFFER.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Partilhar via