DIF_UNREMOVE

Artigo
06/15/2023

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

Nenhum

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

SetupDiUnremoveDevice

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.