DIF_REGISTER_COINSTALLERS
Uma solicitação DIF_REGISTER_COINSTALLERS permite que um instalador participe do registro de co-instaladores de dispositivos.
Quando enviado
Antes de concluir a instalação do 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 para o qual os co-instaladores devem ser registrados.
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
Nenhum
Saída do instalador
Valor retornado do instalador
Um co-instalador pode retornar NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou um código de erro Win32.
Se um instalador de classe lidar com êxito com essa solicitação e SetupDiCallClassInstaller chamar posteriormente o manipulador padrão, o instalador de classe retornará ERROR_DI_DO_DEFAULT.
Se o instalador de classe manipular essa solicitação com êxito, incluindo chamar diretamente o manipulador padrão, o instalador de classe deverá retornar NO_ERROR e SetupDiCallClassInstaller não chamará o manipulador padrão novamente.
Nota O instalador de classe pode chamar diretamente o manipulador padrão, mas o instalador de classe nunca deve tentar substituir as operações do manipulador padrão.
Para obter mais informações sobre como chamar o manipulador padrão, consulte Chamando manipuladores de código DIF padrão.
Se o instalador de classe encontrar um erro, o instalador deverá retornar um código de erro Win32 apropriado e SetupDiCallClassInstaller não chamará posteriormente o manipulador padrão.
Manipulador de código DIF padrão
SetupDiRegisterCoDeviceInstallers
Operação do instalador
Em resposta a uma solicitação de DIF_REGISTER_COINSTALLERS, um instalador pode modificar a lista de co-instaladores para o dispositivo. Por exemplo, um instalador pode registrar ou remover programaticamente um co-instalador específico do dispositivo para o dispositivo baseado na análise do dispositivo.
A menos que o sinalizador DI_NOFILECOPY esteja definido, um instalador que manipula essa solicitação DIF deve copiar arquivos necessários para os co-instaladores.
Se o sinalizador DI_NOFILECOPY estiver claro, mas o sinalizador DI_NOVCP estiver definido, o instalador deverá enfileirar todas as operações de arquivo para a fila de arquivos fornecida, mas não deve confirmar a fila.
Se o instalador retornar um código de erro Win32, o Windows interromperá a instalação.
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) |