Método IPrintOemUni::GetInfo (prcomoem.h)
O método IPrintOemUni::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_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 memória alocada para receber as informações especificadas por 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.
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. |
Observações
Um plug-in de renderização para Unidrv deve implementar o método IPrintOemUni::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.
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) |