Partager via


IPrintOemDriverUI ::D rvUpdateUISetting, méthode (prcomoem.h)

La méthode IPrintOemDriverUI::DrvUpdateUISetting est fournie par les minidrivers Unidrv et Pscript5 afin que les plug-ins d’interface utilisateur puissent notifier 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 Remarques suivante.

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

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 _CPSUICALLBACK-typée 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 spécifiée par la fonction de rappel.

Exigences

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