Méthode IPrintOemPS ::GetInfo (prcomoem.h)
La méthode d’un plug-in de IPrintOemPS::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_GETPUBLISHERINFO
La méthode doit indiquer si le plug-in de rendu utilise le « mode de publication ». Le paramètre pBuffer pointe vers une structure PUBLISHERINFO , à remplir par la méthode . Pour plus d'informations, consultez la section Notes qui suit.
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 IPrintOemPS ::P ublishDriverInterface doit être appelée avec le paramètre pIUnknown pointant vers un objet qui implémente l’interface IPrintCoreHelperPS.
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 fourni par l’appelant vers la mémoire allouée pour recevoir les informations spécifiées par dwMode.
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 |
|---|---|
|
L’opération a réussi. |
|
L’opération a échoué |
|
Cette méthode n'est pas implémentée. |
Remarques
Les plug-ins de rendu pour Pscript5 sont nécessaires pour implémenter la IPrintOemPS::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.
En « mode de publication », toutes les informations de police à télécharger sont placées dans l’en-tête du travail. Chaque police n’est téléchargée qu’une seule fois et peut être utilisée pour n’importe quelle page, ce qui permet à la tâche d’être indépendante de l’ordre des pages. Si dwMode est OEMGI_GETPUBLISHERINFO mais que le plug-in ne prend pas en charge le mode de publication, IPrintOemPS::GetInfo doit retourner E_NOTIMPL.
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) |