Método IPrintOemPS::GetInfo (prcomoem.h)
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 |
|---|---|
|
A operação foi realizada com êxito. |
|
Falha na operação |
|
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) |