événement DBT_DEVICEARRIVAL

  • Article

Le système diffuse l’événement d’appareil DBT_DEVICEARRIVAL lorsqu’un appareil ou un élément multimédia a été inséré et devient disponible.

Pour diffuser cet événement d’appareil, le système utilise le message WM_DEVICECHANGE avec wParam défini sur DBT_DEVICEARRIVAL 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éfinissez sur DBT_DEVICEARRIVAL.

lParam

Pointeur vers une structure identifiant l’appareil inséré. 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

Si le média est inséré, 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.

Configuration requise

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