Función DrvDocumentPropertySheets (winddiui.h)
Los archivos DLL de interfaz de impresora DrvDocumentPropertySheets función es responsable de crear páginas de hojas de propiedades que describen las propiedades de un documento de impresión.
Sintaxis
LONG DrvDocumentPropertySheets(
[in, optional] PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parámetros
[in, optional] pPSUIInfo
Puntero proporcionado por el autor de la llamada a una estructura de PROPSHEETUI_INFO. Puede ser NULL (consulte la sección Comentarios siguiente).
lParam
Valor entero proporcionado por el autor de la llamada que depende del contenido del Reason miembro de la estructura PROPSHEETUI_INFO, como se muestra en la tabla siguiente.
| Valor de motivo | Definición de lParam |
|---|---|
| PROPSHEETUI_REASON_INIT | Puntero a una estructuradeDOCUMENTPROPERTYHEADER. |
| Todos los demás valores de motivo | Consulte la descripción del parámetro lParam para el tipo de función PFNPROPSHEETUI. (La dirección del DOCUMENTPROPERTYHEADER estructura se encuentra en el miembro lParamInit de la estructura de PROPSHEETUI_INFO). |
Valor devuelto
Si pPSUIInfo es NULL y, si lParam :>fMode es cero o lParam ->pdmOut es NULL, esta función debe devolver el tamaño, en bytes, de la estructura deDEVMODEW de laimpresora. De lo contrario, el valor devuelto de la función es el mismo que el descrito en la sección ReturnValue del tipo de función PFNPROPSHEETUI. Para obtener más información, vea la sección Comentarios.
Observaciones
Todos los archivos DLL de interfaz de impresora deben proporcionar una función DrvDocumentPropertySheets, que se define mediante el tipo de función PFNPROPSHEETUI. El propósito de la función es llamar a la función ComPropSheet, proporcionada por CPSUI, para especificar páginas de hojas de propiedades que contengan propiedades modificables de usuario para documentos impresos.
Si el valor recibido para el parámetro pPSUIInfo no es NULL, el administrador de impresión del sistema operativo basado en NT llama a la función indirectamente, a través de CPSUI. Se aplican las reglas siguientes:
La función debe realizar operaciones tal como se describe para el tipo de función PFNPROPSHEETUI.
Las marcas del fMode miembro del DOCUMENTPROPERTYHEADER estructura indican qué páginas de hojas de propiedades se van a mostrar y si el usuario debe poder modificar las propiedades de un documento. Las únicas marcas que se pueden establecer son DM_IN_PROMPT (o DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION y DM_OUT_BUFFER (o DM_COPY).
Si el valor recibido para el parámetro pPSUIInfo es NULL, el administrador de trabajos de impresión llama directamente a la función, sin pasar por CPSUI. En este caso, el parámetro lParam contiene la dirección de una estructura DOCUMENTPROPERTYHEADER y se aplican las reglas siguientes:
Si el miembro fMode del DOCUMENTPROPERTYHEADER estructura es cero, o si el miembro pdmOut de la misma estructura es NULL, la función debe devolver solo el tamaño total de la estructura DEVMODEW de la impresora, incluidos los miembros de estructura pública y privada, en el miembro cb Out de la estructura DOCUMENTPROPERTYHEADER.
Si el fMode miembro de la estructura DOCUMENTPROPERTYHEADER no es cero, la función debe realizar las operaciones indicadas por las marcas de fMode. Las únicas marcas que se pueden establecer son DM_IN_BUFFER (o DM_MODIFY) y DM_OUT_BUFFER (o DM_COPY).
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winddiui.h (incluya Winddiui.h) |