evento DBT_DEVICEREMOVEPENDING

  • Artigo

O sistema transmite o evento DBT_DEVICEREMOVEPENDING dispositivo quando um dispositivo ou parte da mídia está sendo removido e não está mais disponível para uso.

Para transmitir esse evento de dispositivo, o sistema usa a mensagem WM_DEVICECHANGE com wParam definido como DBT_DEVICEREMOVEPENDING 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_DEVICEREMOVEPENDING.

lParam

Um ponteiro para uma estrutura que identifica o dispositivo. 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

Retornar TRUE.

Comentários

O sistema pode transmitir uma mensagem DBT_DEVICEREMOVEPENDING sem enviar uma mensagem de DBT_DEVICEQUERYREMOVE correspondente. Nesses casos, os aplicativos e drivers devem se recuperar da perda do dispositivo da melhor maneira possível.

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