IPrintOemUI ::D evicePropertySheets, méthode (prcomoem.h)

Article
02/29/2024

La IPrintOemUI::DevicePropertySheets méthode permet à un plug-in d’interface utilisateur d’ajouter une nouvelle page à la feuille des propriétés de l’imprimante d’un périphérique d’imprimante.

Syntaxe

HRESULT DevicePropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Paramètres

pPSUIInfo

Pointeur fourni par l’appelant vers une structure PROPSHEETUI_INFO .

lParam

Valeur fournie par l’appelant qui dépend de la valeur de raison dans pPSUIInfo->Reason. La valeur de motif peut être l’une des constantes suivantes, qui sont définies dans compstui.h. Pour plus d’informations sur ces constantes, consultez la section Notes et la description du paramètre lParam dans le type de fonction PFNPROPSHEETUI .

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

Valeur retournée

La valeur de retour dépend du contenu du membre Reason de PROPSHEETUI_INFO structure. Pour plus d’informations, consultez la description de DrvDevicePropertySheets.

Remarques

La méthode d’un IPrintOemUI::DevicePropertySheets plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvDevicePropertySheets exportée par les DLL d’interface d’imprimante en mode utilisateur. Les deux fonctions ont les mêmes paramètres d’entrée.

Si vous fournissez un plug-in d’interface utilisateur, la IPrintOemUI::DevicePropertySheets méthode est appelée après l’appel de la fonction DrvDevicePropertySheets du pilote.

Quand IPrintOemUI::DevicePropertySheets est appelé, le membre lParamInit de la structure PROPSHEETUI_INFO contient l’adresse d’une structure OEMUIPSPARAM .

Si vous implémentez cette méthode, vous fournissez généralement également une fonction de rappel de type _CPSUICALLBACK pour gérer les modifications de l’utilisateur. Cette fonction de rappel doit appeler IPrintOemDriverUI ::D rvUpdateUISetting 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.

Si IPrintOemUI::DevicePropertySheets 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.

Si un plug-in d’interface utilisateur prend en charge plusieurs modèles d’imprimante et que vous souhaitez uniquement afficher la nouvelle page pour certains de ces modèles, la IPrintOemUI::DevicePropertySheets méthode doit simplement fournir une valeur de retour de réussite, sans ajouter réellement la page, pour les modèles qui n’ont pas besoin de la page.

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.