IPrintOemUI ::QueryColorProfile, méthode (prcomoem.h)

Article
02/07/2025

La méthode IPrintOemUI::QueryColorProfile permet à un plug-in d’interface utilisateur de spécifier un profil ICC à utiliser pour la gestion des couleurs.

Syntaxe

HRESULT QueryColorProfile(
  HANDLE    hPrinter,
  POEMUIOBJ poemuiobj,
  PDEVMODE  pPublicDM,
  PVOID     pOEMDM,
  ULONG     ulQueryMode,
  VOID      *pvProfileData,
  ULONG     *pcbProfileData,
  FLONG     *pflProfileData
);

Paramètres

hPrinter

Handle d’imprimante fourni par l’appelant.

poemuiobj

Pointeur fourni par l’appelant vers une structure OEMUIOBJ.

pPublicDM

Pointeur fourni par l’appelant vers une structure DEVMODEW validée.

pOEMDM

Pointeur fourni par l’appelant vers les membres de la structure DEVMODEW privée du plug-in d’interface utilisateur.

ulQueryMode

Un des indicateurs de bits fournis par l’appelant suivant, indiquant le type de profil à spécifier.

Drapeau	Définition
QCP_DEVICEPROFILE	L’appelant demande un profil d’appareil.
QCP_SOURCEPROFILE	L’appelant demande un profil source.

pvProfileData

Pointeur fourni par l’appelant vers une mémoire tampon pour recevoir des informations de profil.

pcbProfileData

Pointeur fourni par l’appelant vers une valeur représentant la taille, en octets, de la mémoire tampon pointée par pvProfileData.

pflProfileData

L’un des indicateurs de bits fournis par la méthode suivants, indiquant le type d’informations retournées par la méthode.

Drapeau	Définition
QCP_PROFILEDISK	La méthode retourne le nom de fichier d’un profil ICC dans la mémoire tampon pointée par pvProfileData.
QCP_PROFILEMEMORY	La méthode retourne des données de profil dans la mémoire tampon pointée par pvProfileData.

Valeur de retour

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

Retourner le code	Description
S_OK	L’opération a réussi.
E_FAIL	L’opération a échoué.
E_NOTIMPL	La méthode n’est pas implémentée.

Remarques

La méthode IPrintOemUI::QueryColorProfile d’un plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvQueryColorProfile exportée par des DLL d’interface d’imprimante en mode utilisateur. Pour plus d’informations sur les événements d’imprimante et leur traitement, consultez la description de la fonction DrvQueryColorProfile.

Si vous fournissez un plug-in d’interface utilisateur, la fonction DrvQueryColorPro file du pilote d’imprimante appelle la méthode IPrintOemUI::QueryColorProfile. La fonction DrvQueryColorProfile effectue son propre traitement pour l’événement spécifié, puis appelle la méthode IPrintOemUI::QueryColorProfile pour gérer le traitement supplémentaire de l’événement.

Si IPrintOemUI::QueryColorProfile méthodes sont exportées par plusieurs plug-ins d’interface utilisateur, les méthodes sont appelées dans l’ordre dans lequel les plug-ins sont spécifiés pour l’installation.

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	prcomoem.h (include Prcomoem.h)

Partager via