DIF_REMOVE

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

Nenhum

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

SetupDiRemoveDevice

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)

Ver também

SetupDiRemoveDevice

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SP_REMOVEDEVICE_PARAMS