DIF_NEWDEVICEWIZARD_SELECT

Artigo
06/15/2023

Uma solicitação de DIF_NEWDEVICEWIZARD_SELECT permite que um instalador forneça páginas personalizadas do assistente que substituem a página de driver de seleção padrão. Essa solicitação só é usada durante a instalação manual de dispositivos não PnP.

Quando enviado

Imediatamente antes do Windows exibir 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

Um instalador responde a essa solicitação DIF para substituir completamente a página padrão do assistente de select-driver. Se, em vez disso, o instalador precisar modificar apenas a página padrão ou modificar a lista de drivers dos quais escolher, o instalador deverá fazer isso em resposta à solicitação de DIF_SELECTDEVICE .

Um co-instalador deve adicionar páginas personalizadas em sua passagem de pós-processamento e somente se o instalador de classe não tiver adicionado páginas personalizadas. Se o instalador de classe adicionou páginas, o co-instalador não deve. Caso contrário, o usuário poderá ser solicitado a escolher um driver duas vezes.

Se um instalador fornecer uma página de seleção personalizada, o instalador deverá definir o driver selecionado. No código do instalador que dá suporte à página do assistente, depois que o usuário clicar em Avançar, o instalador deverá chamar SetupDiSetSelectedDriver.

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.