Share via


Méthode IPrintOemUni ::GetInfo (prcomoem.h)

La méthode d’un plug-in de IPrintOemUni::GetInfo rendu retourne des informations d’identification.

Syntaxe

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Paramètres

dwMode

Contient l’une des constantes entières fournies par l’appelant.

OEMGI_GETREQUESTEDHELPERINTERFACES

La méthode doit écrire la valeur d’indicateur de bits de OEMPUBLISH_IPRINTCOREHELPER dans la mémoire tampon pBuffer si la méthode IPrintOemUni ::P ublishDriverInterface doit être appelée avec le paramètre pIUnknown pointant vers un objet qui implémente l’interface IPrintCoreHelperUni.

OEMGI_GETSIGNATURE

La méthode doit retourner une signature d’identification unique de quatre octets. Le plug-in doit également placer cette signature dans les structures OPTITEM , comme décrit dans la description du OEMCUIPPARAM. membre pOEMOptItems de la structure.

OEMGI_GETVERSION

La méthode doit retourner le numéro de version du plug-in d’interface utilisateur en tant que DWORD. Le format de version est défini par le développeur.

pBuffer

Pointeur vers la mémoire fournie par l’appelant alloué pour recevoir les informations spécifiées par dwInfo.

cbSize

Taille fournie par l’appelant de la mémoire tampon pointée vers pBuffer.

pcbNeeded

Pointeur fourni par l’appelant vers un emplacement pour recevoir le nombre d’octets écrits dans la mémoire tampon pointée vers pBuffer.

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

Un plug-in de rendu pour Unidrv doit implémenter la IPrintOemUni::GetInfo méthode, qui est appelée immédiatement après le chargement du plug-in. La méthode doit retourner les informations spécifiées en les écrivant à l’adresse spécifiée par pBuffer et en écrivant la taille, en octets, des informations retournées dans l’emplacement spécifié par pcbNeededed.

Si pBuffer a la valeur NULL, la méthode doit simplement utiliser pcbNeeded pour renvoyer le nombre d’octets requis pour stocker les informations spécifiées.

Pour plus d’informations sur la création et l’installation de plug-ins de rendu, consultez Personnalisation des pilotes d’imprimante microsoft.

Configuration requise

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

Voir aussi

IPrintOemPS ::GetInfo

IPrintOemUI ::GetInfo

IPrintOemUni