DIF_NEWDEVICEWIZARD_SELECT
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
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.
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.
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