DIF_NEWDEVICEWIZARD_PREANALYZE
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.
Requisitos
Versão |
Com suporte no Microsoft Windows 2000 e versões posteriores do Windows. |
Cabeçalho |
Setupapi.h (inclua Setupapi.h) |