Méthode IPrintOemDriverUI ::D rvUpdateUISetting (prcomoem.h)

Article
03/01/2024

La IPrintOemDriverUI::DrvUpdateUISetting méthode est fournie par les minidrivers Unidrv et Pscript5 afin que les plug-ins d’interface utilisateur puissent informer le pilote d’une option d’interface utilisateur modifiée.

Syntaxe

HRESULT DrvUpdateUISetting(
  PVOID pci,
  PVOID pOptItem,
  DWORD dwPreviousSelection,
  DWORD dwMode
);

Paramètres

pci

Pointeur fourni par l’appelant vers une structure OEMUIOBJ .

pOptItem

Pointeur fourni par l’appelant vers une structure OPTITEM décrivant un élément d’option d’interface utilisateur.

dwPreviousSelection

Non utilisé.

dwMode

Constante entière fournie par l’appelant indiquant à quelle page de feuille de propriétés appartient l’élément d’option fourni. Les constantes suivantes sont valides.

Valeur	Définition
OEMCUIP_DOCPROP	L’élément d’option fourni appartient à la page Avancé de la feuille de propriétés du document.
OEMCUIP_PRNPROP	L’élément d’option fourni appartient à la page Paramètres de l’appareil de la feuille de propriétés de l’imprimante.

Pour plus d'informations, consultez la section Notes qui suit.

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

Si vous fournissez un plug-in d’interface utilisateur qui implémente la méthode IPrintOemUI ::D ocumentPropertySheets ou la méthode IPrintOemUI ::D evicePropertySheets , vous fournissez généralement une fonction de rappel de type _CPSUICALLBACK pour gérer les modifications utilisateur. Cette fonction de rappel doit appeler IPrintOemDriverUI::DrvUpdateUISetting pour informer le pilote lorsque la valeur associée à un paramètre d’interface utilisateur a été modifiée, si la valeur est stockée dans la structure DEVMODEW du pilote (au lieu des membres DEVMODEW privés du plug-in) ou dans les clés de Registre.

La valeur spécifiée pour dwMode doit être basée sur la méthode qui a spécifié la fonction de rappel.

Configuration requise

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

Partager via