DrvDocumentPropertySheets, fonction (winddiui.h)

La fonction DrvDocumentPropertySheets d’une interface d’imprimante est chargée de créer des pages de feuille de propriétés qui décrivent les propriétés d’un document d’impression.

Syntaxe

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

Paramètres

[in, optional] pPSUIInfo

Pointeur fourni par l’appelant vers une structure PROPSHEETUI_INFO . Peut être NULL (voir la section Remarques suivantes).

lParam

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

Valeur de la raison Définition de lParam
PROPSHEETUI_REASON_INIT Pointeur vers une structure DOCUMENTPROPERTYHEADER .
Toutes les autres valeurs de raison Consultez la description du paramètre lParam pour le type de fonction PFNPROPSHEETUI .

(L’adresse de la structure DOCUMENTPROPERTYHEADER est contenue dans le membre lParamInit de la structure PROPSHEETUI_INFO .)

Valeur de retour

Si pPSUIInfo est NULL et si lParam ->fMode est zéro ou lParam ->pdmOut est NULL, cette fonction doit retourner la taille, en octets, de la structure DEVMODEW de l’imprimante. Sinon, la valeur de retour de la fonction est identique à celle décrite dans la section ReturnValue du type de fonction PFNPROPSHEETUI . Pour plus d'informations, consultez la section Notes.

Remarques

Toutes les DLL d’interface d’imprimante doivent fournir une fonction DrvDocumentPropertySheets , 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 des pages de feuille de propriétés contenant des propriétés modifiables par l’utilisateur pour les documents d’impression.

Si la valeur reçue pour le paramètre pPSUIInfo n’est pas NULL, le spouleur d’impression du système d’exploitation NT appelle indirectement la fonction via CPSUI. Les règles suivantes s’appliquent :

  • La fonction doit effectuer des opérations comme décrit pour le type de fonction PFNPROPSHEETUI .
  • Les indicateurs du membre fMode de la structure DOCUMENTPROPERTYHEADER indiquent les pages de feuille de propriétés à afficher et si l’utilisateur doit être autorisé à modifier les propriétés d’un document. Les seuls indicateurs qui peuvent être définis sont DM_IN_PROMPT (ou DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION et DM_OUT_BUFFER (ou DM_COPY).
Si la valeur reçue pour le paramètre pPSUIInfo est NULL, lepooleur d’impression appelle directement la fonction, sans passer par CPSUI. Dans ce cas, le paramètre lParam contient l’adresse d’une structure DOCUMENTPROPERTYHEADER et les règles suivantes s’appliquent :
  • Si le membre fMode de la structure DOCUMENTPROPERTYHEADER est zéro ou si le membre pdmOut de la même structure est NULL, la fonction doit retourner uniquement la taille totale de la structure DEVMODEW de l’imprimante, y compris les membres de structure publique et privée, dans le membre cbOut de la structure DOCUMENTPROPERTYHEADER.
  • Si le membre fMode de la structure DOCUMENTPROPERTYHEADER n’est pas zéro, la fonction doit effectuer les opérations indiquées par les indicateurs fMode . Les seuls indicateurs qui peuvent être définis sont DM_IN_BUFFER (ou DM_MODIFY) et DM_OUT_BUFFER (ou DM_COPY).

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête winddiui.h (inclure Winddiui.h)

Voir aussi

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets