événement DBT_DEVICEREMOVECOMPLETE

  • Article

Le système diffuse l’événement d’appareil DBT_DEVICEREMOVECOMPLETE lorsqu’un appareil ou un élément multimédia a été physiquement supprimé.

Pour diffuser cet événement d’appareil, le système utilise le message WM_DEVICECHANGE avec wParam défini sur DBT_DEVICEREMOVECOMPLETE et lParam défini comme décrit ci-dessous.

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

Paramètres

Hwnd

Handle d'une fenêtre.

uMsg

Identificateur de message WM_DEVICECHANGE .

wParam

Défini sur DBT_DEVICEREMOVECOMPLETE

lParam

Pointeur vers une structure identifiant l’appareil supprimé. La structure se compose d’un en-tête indépendant de l’événement, suivi de membres dépendants des événements qui décrivent l’appareil. Pour utiliser cette structure, traitez la structure comme une structure DEV_BROADCAST_HDR, puis case activée son membre dbch_devicetype pour déterminer le type d’appareil.

Valeur retournée

Retourne TRUE.

Notes

Le système peut diffuser un message DBT_DEVICEREMOVECOMPLETE sans envoyer de messages DBT_DEVICEQUERYREMOVE et DBT_DEVICEREMOVEPENDING correspondants. Dans ce cas, les applications et les pilotes doivent se remettre de la perte de l’appareil du mieux qu’ils peuvent.

Si le média est supprimé, le type d’appareil arrivant est un volume (le membre dbch_devicetype est DBT_DEVTYP_VOLUME) et la modification affecte le média (le membre dbcv_flags est DBTF_MEDIA).

Exemples

Pour obtenir un exemple, consultez Détection de l’insertion ou de la suppression d’un média ou Traitement d’une demande de suppression d’un appareil.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows XP
Serveur minimal pris en charge
 Windows Server 2003
En-tête
Dbt.h

Voir aussi

Événements de l'appareil

événements Gestion des appareils

DEV_BROADCAST_HDR

WM_DEVICECHANGE