DIF_ADDPROPERTYPAGE_ADVANCED

Uma solicitação DIF_ADDPROPERTYPAGE_ADVANCED permite que um instalador forneça uma ou mais páginas de propriedades personalizadas para um dispositivo.

Quando enviado

Quando um usuário clica nas propriedades de um dispositivo em Gerenciador de Dispositivos ou em Painel de Controle.

Quem manipula

Entrada do instalador

DeviceInfoSet
Fornece um identificador para o conjunto de informações do dispositivo que contém o dispositivo.

DeviceInfoData
Opcionalmente, fornece um ponteiro para uma estrutura SP_DEVINFO_DATA que identifica o dispositivo no conjunto de informações do dispositivo. Se DeviceInfoSet for NULL, o Windows solicitará páginas de propriedades para a classe de configuração do dispositivo.

Parâmetros de instalação do dispositivo
Os parâmetros de instalação do dispositivo (SP_DEVINSTALL_PARAMS) são associados ao DeviceInfoData, se especificado, ou ao DeviceInfoSet.

Parâmetros de instalação de classe
Uma estrutura SP_ADDPROPERTYPAGE_DATA é associada ao DeviceInfoData, se especificado, ou ao DeviceInfoSet.

Saída do instalador

Parâmetros de instalação do dispositivo
Um instalador pode modificar os parâmetros de instalação do dispositivo.

Parâmetros de instalação de classe
Um instalador pode modificar o SP_ADDPROPERTYPAGE_DATA para fornecer páginas personalizadas.

Valor retornado do instalador

Um co-instalador pode retornar NO_ERROR ou um erro win32. Um co-instalador não deve retornar ERROR_DI_POSTPROCESSING_REQUIRED para essa solicitação DIF.

Um instalador de classe retornará NO_ERROR se fornecer páginas com êxito. Caso contrário, um instalador de classe retornará ERROR_DI_DO_DEFAULT ou um código de erro Win32.

Manipulador de código DIF padrão

Nenhum

Operação do instalador

Em resposta a essa solicitação DIF, um instalador pode fornecer páginas de propriedades personalizadas. Lidar com essa solicitação DIF permite que você forneça páginas de propriedades de um instalador de classe ou co-instalador e remove a necessidade de uma DLL separada que atue como um provedor de página de propriedades.

Um instalador normalmente manipula essa solicitação DIF para adicionar uma nova página de propriedades específica do dispositivo ou da classe de instalação. Um instalador também pode substituir a página de propriedades do driver fornecida pelo sistema, a página de propriedades do recurso ou a página de propriedades de energia de um dispositivo. Se um instalador substituir uma página fornecida pelo sistema, o instalador deverá definir o sinalizador apropriado nos parâmetros de instalação do dispositivo para o dispositivo:

DI_DRIVERPAGE_ADDED
O instalador forneceu uma página de propriedades do driver.

DI_RESOURCEPAGE_ADDED
O instalador forneceu uma página de propriedades de recurso.

DI_FLAGSEX_POWERPAGE_ADDED
O instalador forneceu uma página de propriedades de energia.

Um instalador não pode substituir a página de propriedades gerais fornecida pelo sistema.

O Windows exibe apenas uma página de driver, uma página de recurso e uma página de energia para um dispositivo. Um instalador não deverá fornecer uma página do sistema de substituição se um instalador anterior já tiver fornecido uma página desse tipo. Essa restrição não se aplica a páginas de propriedades não fornecidas pelo sistema.

Um co-instalador deve adicionar páginas personalizadas em sua passagem de pré-processamento.

Se um instalador permitir que um usuário defina uma propriedade que exija que o Windows remova e reinicie o dispositivo, o instalador deverá definir o sinalizador DI_FLAGSEX_PROPCHANGE_PENDING nos parâmetros de instalação do dispositivo de sua rotina DialogProc .

Para obter mais informações sobre como fornecer páginas de propriedades do dispositivo, consulte Fornecendo páginas de propriedades do dispositivo.

Para obter mais informações sobre códigos DIF, consulte Manipulando códigos DIF.

Requisitos

Confira também

SP_ADDPROPERTYPAGE_DATA

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS