DIF_NEWDEVICEWIZARD_PRESELECT
Uma solicitação de DIF_NEWDEVICEWIZARD_PRESELECT permite que um instalador forneça páginas do assistente que o Windows exibe ao usuário antes de exibir a página select-driver. Essa solicitação só é usada durante a instalação manual de dispositivos não PnP.
Quando enviado
Depois que o usuário tiver selecionado a classe para o dispositivo, mas antes que o Windows exiba a página "Selecionar um Driver de Dispositivo".
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.
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_PRESELECT permite que um instalador forneça páginas do assistente que o Windows exibe ao usuário antes de exibir a página select-driver. Essa solicitação só é usada durante a instalação manual de dispositivos não PnP.
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 co-instalador pode adicionar páginas personalizadas em sua passagem de pré-processamento e/ou em sua passagem de pós-processamento. Se ele adicionar páginas em sua passagem de pré-processamento, essas páginas serão exibidas antes de qualquer página fornecida pelo instalador de classe.
Se um ou mais instaladores adicionarem páginas de pré-seleção personalizadas, o Windows exibirá as páginas antes da página "Selecionar um Driver de Dispositivo". No entanto, se o usuário pressionar "Voltar" na página select-driver, o Windows ignorará as páginas de pré-seleção personalizadas e voltará para a página de seleção de classe "Tipo de Hardware".
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) |
Confira também
DIF_NEWDEVICEWIZARD_PREANALYZE
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de