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

  • Article

La IPrintOemPS::PublishDriverInterface méthode permet à un plug-in de rendu pour Pscript5 d’obtenir l’interface IPrintCorePS2, IPrintOemDriverPS ou IPrintCoreHelperPS du pilote Pscript5.

Syntaxe

HRESULT PublishDriverInterface(
  IUnknown *pIUnknown
);

Paramètres

pIUnknown

Pointeur fourni par l’appelant vers l’interface IUnknown de l’interface COM IPrintCorePS2 du pilote, de l’interface COM IPrintOemDriverPS ou de l’interface IPrintCoreHelperPS du pilote.

Valeur retournée

La méthode doit retourner l’une des valeurs suivantes.

Code de retour Description
S_OK
 L’opération a réussi.
E_FAIL
 L’opération a échoué

Remarques

Le pilote Pscript5 prend en charge les interfaces IPrintCorePS2, IPrintOemDriverPS et IPrintCoreHelperPS . Un plug-in de rendu pour Pscript5 doit implémenter la IPrintOemPS::PublishDriverInterface méthode . La méthode doit retourner des informations sur ses interfaces Pscript5 prises en charge comme suit :

  1. Le pilote Pscript5 appelle d’abord la IPrintOemPS::PublishDriverInterface méthode avec le pointeur pIUnknown défini sur l’interface IUnknown du instance IPrintCorePS2. Si le plug-in de rendu peut utiliser l’interface IPrintCorePS2 , la méthode doit retourner S_OK. Sinon, le plug-in doit retourner E_FAIL.
  2. Si le plug-in a retourné E_FAIL, le pilote Pscript5 appelle à nouveau la IPrintOemPS::PublishDriverInterface méthode, mais avec le pointeur pIUnknown défini sur l’interface IPrintOemDriverPS du instance IUnknown. Si le plug-in peut utiliser l’interface IPrintOemDriverPS , la méthode doit retourner S_OK. Sinon, le plug-in doit retourner E_FAIL.
  3. Si la méthode IPrintOemPS ::GetInfo du plug-in a retourné une valeur de OEMPUBLISH_IPRINTCOREHELPER dans pBuffer en réponse à un appel avec dwMode défini sur OEMGI_GETREQUESTEDHELPERINTERFACES dans pBuffer, le pilote Pscript5 appelle à nouveau la IPrintOemPS::PublishDriverInterface méthode, mais avec le pointeur pIUnknown défini sur un objet qui implémente les interfaces IPrintCoreHelperPS et IPrintCoreHelper . Si le plug-in conserve un pointeur vers l’interface objet, la méthode doit retourner S_OK. Sinon, la méthode doit retourner E_FAIL.
Si le plug-in échoue tous les appels à IPrintOemPS::PublishDriverInterface, le plug-in ne reçoit pas d’autres appels. Si le plug-in appelle les méthodes d’interface IPrintCorePS2, IPrintOemDriverPS ou IPrintCoreHelperPS, il doit utiliser le pointeur d’interface IUnknown reçu pour appeler IUnknown ::QueryInterface (décrit dans la documentation Microsoft Windows SDK) afin d’obtenir un pointeur vers la version prise en charge par le pilote du IPrintCorePS2, IPrintOemDriverPS ou Interface IPrintCoreHelperPS. Pour plus d’informations, consultez Accès aux interfaces de pilote d’imprimante à partir de plug-ins.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête prcomoem.h (include Prcomoem.h)

Voir aussi

IPrintOemPS

IPrintOemPS ::GetInfo