Función DrvDocumentPropertySheets (winddiui.h)

La función DrvDocumentPropertySheets de una interfaz de impresora 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 siguiente sección Comentarios).

lParam

Valor entero proporcionado por el autor de la llamada que depende del contenido del miembro Reason de la estructura de PROPSHEETUI_INFO, como se muestra en la tabla siguiente.

Valor de motivo	Definición de lParam
PROPSHEETUI_REASON_INIT	Puntero a una estructura DOCUMENTPROPERTYHEADER .
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 de la estructura DOCUMENTPROPERTYHEADER se encuentra en el miembro lParamInit de la estructura PROPSHEETUI_INFO ).

Valor devuelto

Si pPSUIInfo es NULL y lParam ->fMode es cero o lParam ->pdmOut es NULL, esta función debe devolver el tamaño, en bytes, de la estructura DEVMODEW de la impresora. 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.

Comentarios

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 por el usuario para documentos impresos.

Si el valor recibido para el parámetro pPSUIInfo no es NULL, el administrador de trabajos 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 como se describe para el tipo de función PFNPROPSHEETUI .

• Las marcas del miembro fMode de la estructura DOCUMENTPROPERTYHEADER indican qué páginas de hoja de propiedades mostrar y si se debe permitir al usuario 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 a la función directamente, 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 de la estructura DOCUMENTPROPERTYHEADER 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 cbOut de la estructura DOCUMENTPROPERTYHEADER.

• Si el miembro fMode de la estructura DOCUMENTPROPERTYHEADER no es cero, la función debe realizar las operaciones indicadas por las marcas fMode . Las únicas marcas que se pueden establecer son DM_IN_BUFFER (o DM_MODIFY) y DM_OUT_BUFFER (o DM_COPY).

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	winddiui.h (incluya Winddiui.h)

Consulte también

DOCUMENTPROPERTYHEADER

DrvDevicePropertySheets

IPrintOemUI::D ocumentPropertySheets