evento DBT_DEVICEQUERYREMOVE

  • Artigo

O sistema transmite o evento do dispositivo DBT_DEVICEQUERYREMOVE para solicitar permissão para remover um dispositivo ou uma parte da mídia. Essa mensagem é a última chance para aplicativos e drivers se prepararem para essa remoção. No entanto, qualquer aplicativo pode negar essa solicitação e cancelar a operação.

Para transmitir esse evento de dispositivo, o sistema usa a mensagem WM_DEVICECHANGE com wParam definido como DBT_DEVICEQUERYREMOVE e lParam definidos conforme descrito a seguir.

LRESULT CALLBACK WindowProc(
  HWND hwnd,       // handle to window
  UINT uMsg,       // WM_DEVICECHANGE
  WPARAM wParam,   // device-change event
  LPARAM lParam    // event-specific data
);

Parâmetros

hwnd

Um identificador para uma janela.

uMsg

O identificador de mensagem WM_DEVICECHANGE .

wParam

Defina como DBT_DEVICEQUERYREMOVE.

lParam

Um ponteiro para uma estrutura que identifica o dispositivo a ser removido. A estrutura consiste em um cabeçalho independente de evento, seguido por membros dependentes de eventos que descrevem o dispositivo. Para usar essa estrutura, trate a estrutura como uma estrutura DEV_BROADCAST_HDR e, em seguida, marcar seu membro dbch_devicetype para determinar o tipo de dispositivo.

Valor retornado

Retorne TRUE para conceder permissão para remover um dispositivo.

Retorne BROADCAST_QUERY_DENY para negar permissão para remover um dispositivo.

Comentários

Você deve fechar todos os identificadores do dispositivo ou a remoção do dispositivo falhará.

Exemplos

Para obter um exemplo, consulte Processando uma solicitação para remover um dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows XP
Servidor mínimo com suporte
 Windows Server 2003
Cabeçalho
Dbt.h

Confira também

Eventos do dispositivo

Eventos de Gerenciamento de Dispositivos

DEV_BROADCAST_HDR

WM_DEVICECHANGE