Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um pedido de DIF_REMOVE notifica o instalador de que Windows está prestes a remover um dispositivo e dá ao instalador a oportunidade de se preparar para a remoção.
Quando enviado
Quando um utilizador remove um dispositivo no Gestor de Dispositivos.
Quem Lida
Co-instalador de classe |
Consegue lidar |
Co-instalador de dispositivos |
Consegue lidar |
Instalador da Classe |
Consegue lidar |
Entrada do Instalador
DeviceInfoSet
Fornece uma alavanca ao conjunto de informação do dispositivo que contém o dispositivo a ser removido.
DeviceInfoData
Fornece um ponteiro para uma estrutura SP_DEVINFO_DATA para o dispositivo no conjunto de informação do dispositivo.
Parâmetros de Instalação do Dispositivo
Existem parâmetros de instalação de dispositivos (SP_DEVINSTALL_PARAMS) associados ao DeviceInfoData.
Parâmetros de Instalação da Classe
Uma estrutura SP_REMOVEDEVICE_PARAMS pode estar associada ao DeviceInfoData.
Não existem parâmetros de instalação de classe para o pedido se a flag de DI_CLASSINSTALLPARAMS estiver clara no SP_DEVINSTALL_PARAMS. Neste caso, não é especificado nenhum perfil de hardware e o dispositivo deve ser removido do sistema como um todo.
Saída do Instalador
Valor de Retorno do Instalador
Um co-instalador pode devolver NO_ERROR, ERROR_DI_POSTPROCESSING_REQUIRED ou um código de erro Win32.
Se um instalador de classes gerir com sucesso este pedido e o SetupDiCallClassInstaller chamar posteriormente o handler predefinido, o instalador de classes devolve ERROR_DI_DO_DEFAULT.
Se o instalador de classes tratar com sucesso este pedido, incluindo chamar diretamente o handler por defeito, o instalador de classes deverá devolver NO_ERROR e o SetupDiCallClassInstaller não voltará a chamar o handler por defeito.
Nota O instalador de classes pode chamar diretamente o handler por defeito, mas o instalador de classes nunca deve tentar substituir as operações do handler por defeito.
Para mais informações sobre como chamar o handler padrão, veja Chamar Handlers de Código DIF por defeito.
Se o instalador de classes encontrar um erro, deverá devolver um código de erro Win32 apropriado e o SetupDiCallClassInstaller não chamará posteriormente o handler predefinido.
Manipulador de Código DIF por Defeito
Operação do Instalador
Em resposta a um pedido de DIF_REMOVE, um instalador normalmente realiza algumas operações de limpeza. Neste caso, um co-instalador devolve NO_ERROR e um instalador de classe devolve ERROR_DI_DO_DEFAULT.
Se um instalador determinar que o dispositivo não deve ser removido, falha o pedido DIF ao devolver um código de erro Win32. Se a flag de DI_QUIETINSTALL estiver limpa, o instalador deve mostrar uma mensagem ao utilizador a explicar porque é que o dispositivo não está a ser removido.
Os co-instaladores não devem tentar remover o dispositivo eles próprios chamando o SetupDiRemoveDevice. Os co-instaladores normalmente tratam deste pedido no pós-processamento, depois de o dispositivo ser removido com sucesso.
Se um co-instalador tiver de eliminar informação do registo, por exemplo, o co-instalador deve fazê-lo no pós-processamento e apenas se os instaladores anteriores tiverem tido sucesso no pedido de remoção. Na sua passagem de pré-processamento, o co-instalador deve armazenar a informação do registo no seu parâmetro de contexto e devolver ERROR_DI_POSTPROCESSING_REQUIRED para solicitar o pós-processamento. Quando Windows chamar o co-instalador para o pós-processamento deste pedido DIF, o co-instalador deve verificar se o estado do DIF está NO_ERROR e depois eliminar a informação do registo. Se um co-instalador apagar informações do registo na sua passagem de pré-processamento e o instalador da classe (ou outro co-instalador) falhar a DIF_REMOVE, o co-instalador pode deixar o dispositivo num estado imprevisível.
Os instaladores não devem apagar ficheiros ao lidar com este pedido DIF, caso os ficheiros estejam a ser usados por outro dispositivo.
O Windows envia este pedido DIF antes de iniciar o processamento PnP de remoção e remoção de consultas.
Para mais informações sobre códigos DIF, consulte Gestão de Códigos DIF.
Requirements
Version |
Suportado em versões Microsoft Windows 2000 e posteriores do Windows. |
Header |
Setupapi.h (incluir Setupapi.h) |