DIF_NEWDEVICEWIZARD_PREANALYZE

Artigo
06/15/2023

Uma solicitação de DIF_NEWDEVICEWIZARD_PREANALYZE permite que um instalador forneça páginas do assistente que o Windows exibe ao usuário antes de exibir a página de análise. Essa solicitação só é usada durante a instalação manual de dispositivos não PnP.

Quando enviado

Depois que o usuário tiver selecionado um driver, mas antes que o Windows registre o dispositivo que torna o nó do dispositivo (devnode) "ativo".

Quem manipula

Co-instalador de classe	Pode manipular
Co-instalador de dispositivo	Não manipula
Instalador de Classe	Pode manipular

Entrada do instalador

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

DeviceInfoData
Fornece um ponteiro para uma estrutura SP_DEVINFO_DATA que identifica o dispositivo no conjunto de informações do dispositivo.

Parâmetros de instalação do dispositivo
Há parâmetros de instalação do dispositivo (SP_DEVINSTALL_PARAMS) associados ao DeviceInfoData.

Parâmetros de instalação de classe
Uma estrutura SP_NEWDEVICEWIZARD_DATA está associada ao DeviceInfoData.

Saída do instalador

Parâmetros de instalação do dispositivo
Um instalador pode modificar os sinalizadores nos parâmetros de instalação do dispositivo. O Windows não marcar os sinalizadores após a conclusão dessa solicitação DIF. No entanto, ele os verifica posteriormente no processo de instalação.

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

Valor retornado do instalador

Se um co-instalador não manipular essa solicitação DIF, ele retornará NO_ERROR de sua passagem de pré-processamento. Se um co-instalador manipular essa solicitação, ele poderá retornar NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou um código de erro win32.

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

Uma solicitação de DIF_NEWDEVICEWIZARD_PREANALYZE permite que um instalador forneça páginas do assistente que o Windows exibe ao usuário antes de exibir a página de análise. Essas páginas podem ser consideradas como páginas "postelect". Essa solicitação só é usada durante a instalação manual de dispositivos não PnP.

Um instalador pode usar uma página de pré-análise personalizada, por exemplo, para escolher uma porta COM depois que um dispositivo modem é selecionado.

Se um instalador adicionar páginas de pré-seleção personalizadas, o instalador deverá primeiro marcar se NumDynamicPages nos parâmetros de instalação de classe atingiu MAX_INSTALLWIZARD_DYNAPAGES.

Um instalador deve fornecer um título de cabeçalho do Assistente 97 e um subtítulo de cabeçalho na estrutura PROPSHEETPAGE para uma página de assistente personalizada. Um instalador não deve substituir o título do assistente fornecido pelo sistema. Consulte o SDK do Microsoft Windows para obter a documentação da estrutura PROPSHEETPAGE e para obter mais informações sobre páginas de propriedades.

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