DIF_UNREMOVE
Uma solicitação DIF_UNREMOVE notifica o instalador de que o Windows está prestes a restabelecer um dispositivo em um determinado perfil de hardware e dá ao instalador a oportunidade de participar da operação. O Windows envia apenas essa solicitação para dispositivos não PnP.
Quando enviado
Quando um dispositivo não PnP enumerado por raiz é reintegrado a um perfil de hardware.
Quem manipula
Co-instalador de classe |
Pode manipular |
Co-instalador de dispositivo |
Pode manipular |
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_UNREMOVEDEVICE_PARAMS está associada ao DeviceInfoData. O campo Escopo deve ser definido como DI_UNREMOVEDEVICE_CONFIGSPECIFIC e um perfil de hardware deve ser especificado no campo HwProfile .
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 manipular com êxito essa solicitação e SetupDiCallClassInstaller precisar chamar posteriormente o manipulador padrão, o instalador de classe retornará ERROR_DI_DO_DEFAULT.
Se o instalador de classe manipular com êxito essa solicitação, 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
Operação do instalador
"Cancelar a movimentação" de um dispositivo basicamente significa que o Windows limpa um sinalizador que marcou anteriormente um dispositivo como "não presente" em um perfil de hardware específico.
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. |
parâmetro |
Setupapi.h (inclua Setupapi.h) |