Método IPrintOemPS::GetInfo (prcomoem.h)
O método IPrintOemPS::GetInfo de 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_GETPUBLISHERINFO
O método deve indicar se o plug-in de renderização usará "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 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 memória alocada para receber as informações especificadas por dwMode.
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.
Valor de retorno
O método deve retornar um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
Falha na operação |
|
O método não é implementado. |
Observações
Os plug-ins de renderização para Pscript5 são necessários para implementar o método IPrintOemPS::GetInfo, que é chamado imediatamente após o plug-in ser carregado. O método deve retornar as informações especificadas escrevendo-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 oferecer 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 os drivers de impressora da Microsoft.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |