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

  • Artigo

O método de um plug-in de IPrintOemPS::GetInfo 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 de inteiro fornecidas pelo chamador.

OEMGI_GETPUBLISHERINFO

O método deve indicar se o plug-in de renderização usará o "modo de publicação". O parâmetro pBuffer aponta para uma estrutura PUBLISHERINFO , a ser preenchida pelo método . Para obter mais informações, consulte a seção Comentários a seguir.

OEMGI_GETREQUESTEDHELPERINTERFACES

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

OEMGI_GETSIGNATURE

O método deve retornar uma assinatura exclusiva de identificação 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 por dwMode.

cbSize

Tamanho fornecido pelo chamador do buffer apontado pelo 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
E_NOTIMPL
 O método não está implementado.

Comentários

Os plug-ins de renderização para Pscript5 são necessários para implementar o IPrintOemPS::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.

No "modo de publicação", todas as informações de fonte a serem baixadas são colocadas no cabeçalho do trabalho. Cada fonte é baixada apenas uma vez e pode ser usada para qualquer página, permitindo que o trabalho seja independente de ordem de página. Se dwMode for OEMGI_GETPUBLISHERINFO mas o plug-in não der suporte ao modo de publicação, IPrintOemPS::GetInfo deverá retornar E_NOTIMPL.

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

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo