Méthode IPrintOemUI ::QueryColorProfile (prcomoem.h)

Article
02/26/2024

La IPrintOemUI::QueryColorProfile méthode 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

Poignée d’imprimante fournie 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 structure DEVMODEW privés du plug-in d’interface utilisateur.

ulQueryMode

L’un des indicateurs de bits fournis par l’appelant suivants, indiquant le type de profil à spécifier.

Indicateur	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.

Indicateur	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 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é.
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

La méthode d’un IPrintOemUI::QueryColorProfile plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvQueryColorProfile qui est exportée par les DLL d’interface d’imprimante en mode utilisateur. Pour plus d’informations sur les événements d’imprimante et la façon dont ils doivent être traités, consultez la description de la fonction DrvQueryColorProfile .

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

Si IPrintOemUI::QueryColorProfile les 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’imprimante de Microsoft.

Configuration requise

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

Partager via