Método IPrintOemUni::GetInfo (prcomoem.h)

O método de IPrintOemUni::GetInfo um plug-in de renderização retorna informações de identificação.

Sintaxe

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Parâmetros

dwMode

Contém uma das seguintes constantes inteiros fornecidas pelo chamador.

OEMGI_GETREQUESTEDHELPERINTERFACES

O método deve gravar o valor do sinalizador de bit de OEMPUBLISH_IPRINTCOREHELPER no buffer pBuffer se o método IPrintOemUni::P ublishDriverInterface deve ser chamado com o parâmetro pIUnknown apontando para um objeto que implementa a Interface IPrintCoreHelperUni.

OEMGI_GETSIGNATURE

O método deve retornar uma assinatura de identificação exclusiva de quatro bytes. O plug-in também deve colocar essa assinatura em estruturas OPTITEM , conforme descrito na descrição do OEMCUIPPARAM. membro pOEMOptItems da estrutura.

OEMGI_GETVERSION

O método deve retornar o número de versão do plug-in da interface do usuário como um DWORD. O formato de versão é definido pelo desenvolvedor.

pBuffer

Ponteiro fornecido pelo chamador para a memória alocada para receber as informações especificadas pelo dwInfo.

cbSize

Tamanho fornecido pelo chamador do buffer apontado por pBuffer.

pcbNeeded

Ponteiro fornecido pelo chamador para um local para receber o número de bytes gravados no buffer apontado por pBuffer.

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.

Comentários

Um plug-in de renderização para Unidrv deve implementar o IPrintOemUni::GetInfo método , que é chamado imediatamente após o plug-in ser carregado. O método deve retornar as informações especificadas gravando-as no endereço especificado por pBuffer e gravando o tamanho, em bytes, das informações retornadas no local especificado por pcbNeeded.

Se pBuffer for NULL, o método deverá usar apenas pcbNeeded para retornar o número de bytes necessários para armazenar as informações especificadas.

Para obter mais informações sobre como criar e instalar plug-ins de renderização, consulte Personalizando drivers de impressora da Microsoft.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintOemPS::GetInfo

IPrintOemUI::GetInfo

IPrintOemUni