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

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

Sintaxe

HRESULT PublishDriverInterface(
  IUnknown *pIUnknown
);

Parâmetros

pIUnknown

Ponteiro fornecido pelo chamador para a interface IUnknown da interface COM IPrintCorePS2 do driver, interface COM IPrintOemDriverPS ou Interface IPrintCoreHelperPS do driver.

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

Comentários

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

  1. O driver Pscript5 primeiro chama o IPrintOemPS::PublishDriverInterface método com o ponteiro pIUnknown definido como a interface IUnknown da instância 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 IPrintOemPS::PublishDriverInterface método novamente, mas com o ponteiro pIUnknown definido como a interface IUnknown da instância IPrintOemDriverPS. 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 no pBuffer em resposta a uma chamada com dwMode definido como OEMGI_GETREQUESTEDHELPERINTERFACES no pBuffer, o driver Pscript5 chamará o IPrintOemPS::PublishDriverInterface método 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 métodos de interface IPrintCorePS2, IPrintOemDriverPS ou IPrintCoreHelperPS, ele deverá 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 IPrintCoreHelperPS. Para obter mais informações, consulte Acessando interfaces de driver de impressora de plug-ins.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintOemPS

IPrintOemPS::GetInfo