Fonction DrvDevicePropertySheets (winddiui.h)

  • Article

La fonction DrvDevicePropertySheets d’une DLL d’imprimante est chargée de créer des pages de feuille de propriétés qui décrivent les propriétés d’une imprimante.

Syntaxe

LONG DrvDevicePropertySheets(
  [in, optional] PPROPSHEETUI_INFO pPSUIInfo,
                 LPARAM            lParam
);

Paramètres

[in, optional] pPSUIInfo

Pointeur fourni par l’appelant vers une structure PROPSHEETUI_INFO .

lParam

Valeur entière fournie par l’appelant qui dépend du contenu du membre Reason de la structure PROPSHEETUI_INFO, comme indiqué dans le tableau suivant.

Valeur de motif Définition de lParam
PROPSHEETUI_REASON_INIT Pointeur vers une structure DEVICEPROPERTYHEADER .
Toutes les autres valeurs de raison Consultez la description du paramètre lParam pour le type de fonction PFNPROPSHEETUI . (L’adresse de la structure DEVICEPROPERTYHEADER est contenue dans le membre lParamInit de la structure PROPSHEETUI_INFO .)

Valeur retournée

Consultez la section ReturnValue dans la description du type de fonction PFNPROPSHEETUI .

Remarques

Toutes les DLL d’interface d’imprimante doivent fournir une fonction DrvDevicePropertySheets , qui est définie à l’aide du type de fonction PFNPROPSHEETUI . L’objectif de la fonction est d’appeler la fonction ComPropSheet , fournie par CPSUI, pour spécifier une page de feuille de propriétés contenant des propriétés modifiables par l’utilisateur pour l’imprimante.

La fonction doit effectuer les opérations décrites pour le type de fonction PFNPROPSHEETUI . La fonction doit créer la page de feuille de propriétés DeviceSettings de l’imprimante (voir le membre pDlgPage de la structure COMPROPSHEETUI ).

Les paramètres du périphérique d’imprimante doivent être stockés dans le Registre. Si un utilisateur disposant de privilèges d’administrateur modifie les options de la page DeviceSettings, la fonction DrvDevicePropertySheets doit écrire les valeurs mises à jour dans le Registre en appelant SetPrinterData (décrit dans la documentation Microsoft Windows SDK).

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête winddiui.h (incluez Winddiui.h)

Voir aussi

DrvDocumentPropertySheets

IPrintOemUI ::D evicePropertySheets