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

  • Artigo

O IPrintOemDriverUni::DrvGetGPDData método é 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 DEVOBJ .

dwType

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

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

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.

Retornar valor

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

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_FAIL
 Falha na operação.
E_NOTIMPL
 O método não está implementado.

Comentários

Se o buffer especificado por pBuffer e cbSize for muito pequeno para receber as informações solicitadas, o 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
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)