Partilhar via


Função DrvDevicePropertySheets (winddiui.h)

A função DrvDevicePropertySheets de uma interface de impressora é responsável por criar páginas de folha de propriedades que descrevem as propriedades de uma impressora.

Sintaxe

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

Parâmetros

[in, optional] pPSUIInfo

Ponteiro fornecido pelo chamador para uma estrutura PROPSHEETUI_INFO.

lParam

Valor inteiro fornecido pelo chamador que depende do conteúdo do Reason membro da estrutura PROPSHEETUI_INFO, conforme listado na tabela a seguir.

Valor do motivo Definição de lParam
PROPSHEETUI_REASON_INIT Ponteiro para uma estrutura deDEVICEPROPERTYHEADER.
Todos os outros valores de motivo Consulte a descrição do parâmetro lParam para o tipo de função PFNPROPSHEETUI. (O endereço da estruturaDEVICEPROPERTYHEADER está contido no lParamInit membro da estrutura PROPSHEETUI_INFO.)

Valor de retorno

Consulte a seção ReturnValue na descrição do tipo de função PFNPROPSHEETUI.

Observações

Todas as DLLs da interface da impressora devem fornecer uma função DrvDevicePropertySheets, que é definida usando o tipo de função PFNPROPSHEETUI. A finalidade da função é chamar a função ComPropSheet, fornecida por CPSUI, para especificar uma página de folha de propriedades contendo propriedades modificáveis pelo usuário para a impressora.

A função deve executar operações conforme descrito para o tipo de função PFNPROPSHEETUI. A função deve criar a página da folha de propriedades DeviceSettings da impressora (consulte o pDlgPage membro da estrutura deCOMPROPSHEETUI).

As configurações do dispositivo de impressora devem ser armazenadas no registro. Se um usuário com privilégio de administrador modificar opções na página DeviceSettings, a função DrvDevicePropertySheets deverá gravar os valores atualizados no registro chamando SetPrinterData (descrito na documentação do SDK do Microsoft Windows).

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho winddiui.h (inclua Winddiui.h)

Consulte também

DrvDocumentPropertySheets

IPrintOemUI::D evicePropertySheets