Compartilhar via

Método IPrintOemPS::P ublishDriverInterface (prcomoem.h)

  • Artigo

O método IPrintOemPS::PublishDriverInterface permite que um plug-in de renderização para Pscript5 obtenha o IPrintCorePS2do driver Pscript5, IPrintOemDriverPS ou interface de IPrintCoreHelperPS.

Sintaxe

HRESULT PublishDriverInterface(
  IUnknown *pIUnknown
);

Parâmetros

pIUnknown

Ponteiro fornecido pelo chamador para a interface IUnknown do de interface COMIPrintCorePS2 do driver, interface COM IPrintOemDriverPSou interface IPrintCoreHelperPS.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
 A operação foi bem-sucedida.
E_FAIL
 Falha na operação

Observações

O driver Pscript5 dá suporte às interfaces IPrintCorePS2, IPrintOemDriverPSe IPrintCoreHelperPS. Um plug-in de renderização para Pscript5 deve implementar o método IPrintOemPS::PublishDriverInterface. O método deve retornar informações sobre suas interfaces Pscript5 com suporte da seguinte maneira:

  1. O driver Pscript5 primeiro chama o método IPrintOemPS::PublishDriverInterface com o ponteiro pIUnknown definido como a interface de IUnknown IPrintCorePS2. Se o plug-in de renderização puder usar a interface IPrintCorePS2, o método deverá retornar S_OK. Caso contrário, o plug-in deverá retornar E_FAIL.
  2. Se o plug-in tiver retornado E_FAIL, o driver Pscript5 chamará o método IPrintOemPS::PublishDriverInterface novamente, mas com o ponteiro pIUnknown definido como a interface IPrintOemDriverPS instância IUnknown. Se o plug-in puder usar a interface IPrintOemDriverPS, o método deverá retornar S_OK. Caso contrário, o plug-in deverá retornar E_FAIL.
  3. Se o método IPrintOemPS::GetInfo do plug-in tiver retornado um valor de OEMPUBLISH_IPRINTCOREHELPER em pBuffer em resposta a uma chamada com dwMode definido como OEMGI_GETREQUESTEDHELPERINTERFACES em pBuffer, o driver Pscript5 chamará o método IPrintOemPS::PublishDriverInterface novamente, mas com o ponteiro pIUnknown definido como um objeto que implementa as interfaces IPrintCoreHelperPS e IPrintCoreHelper. Se o plug-in reter um ponteiro para a interface do objeto, o método deverá retornar S_OK. Caso contrário, o método deverá retornar E_FAIL.
Se o plug-in falhar em todas as chamadas para IPrintOemPS::PublishDriverInterface, o plug-in não receberá mais chamadas. Se o plug-in chamar iPrintCorePS2, IPrintOemDriverPS ou métodos de interface IPrintCoreHelperPS, ele deve usar o ponteiro de interface IUnknown recebido para chamar IUnknown::QueryInterface (descrito na documentação do SDK do Microsoft Windows) para obter um ponteiro para a versão com suporte do driver do IPrintCorePS2, IPrintOemDriverPS ou interface de IPrintCoreHelperPS. Para obter mais informações, consulte acessando interfaces de driver de impressora de plug-ins.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho prcomoem.h (inclua Prcomoem.h)

Consulte também

IPrintOemPS

IPrintOemPS::GetInfo