_Message WM DEVICECHANGE

Avertit une application d’une modification apportée à la configuration matérielle d’un appareil ou de l’ordinateur.

Une fenêtre reçoit ce message par le biais de sa fonction WindowProc .

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 de la fenêtre.

uMsg

Identificateur WM _ DEVICECHANGE .

wParam

Événement qui s’est produit. Ce paramètre peut avoir l’une des valeurs suivantes du fichier d’en-tête DBT. h.

Valeur Signification
DBT _ DEVNODES _ modifié
0x0007
Un appareil a été ajouté ou supprimé du système.
DBT _ QUERYCHANGECONFIG
0x0017
Une autorisation est requise pour modifier la configuration actuelle (ancrer ou détacher).
DBT _ CONFIGCHANGED
0x0018
La configuration actuelle a changé, en raison d’une station d’accueil ou d’une déconnexion.
DBT _ CONFIGCHANGECANCELED
0x0019
Une demande de modification de la configuration actuelle (ancrer ou détacher) a été annulée.
DBT _ DEVICEARRIVAL
0x8000
Un appareil ou un élément multimédia a été inséré et est maintenant disponible.
DBT _ DEVICEQUERYREMOVE
0x8001
Une autorisation est requise pour supprimer un périphérique ou un élément multimédia. Toute application peut refuser cette demande et annuler la suppression.
DBT _ DEVICEQUERYREMOVEFAILED
0x8002
Une demande de suppression d’un appareil ou d’un élément multimédia a été annulée.
DBT _ DEVICEREMOVEPENDING
0x8003
Un appareil ou un élément multimédia est sur le lieu d’être supprimé. Ne peut pas être refusé.
DBT _ DEVICEREMOVECOMPLETE
0x8004
Un appareil ou un élément multimédia a été supprimé.
DBT _ DEVICETYPESPECIFIC
0x8005
Un événement spécifique à l’appareil s’est produit.
DBT _ CUSTOMEVENT
0x8006
Un événement personnalisé s’est produit.
DBT _ USERDEFINED
0xFFFF
La signification de ce message est définie par l’utilisateur.

lParam

Pointeur vers une structure qui contient des données spécifiques à l’événement. Son format dépend de la valeur du paramètre wParam . Pour plus d’informations, reportez-vous à la documentation de chaque événement.

Valeur de retour

Retourne la valeur true pour accorder la demande.

Retourne la _ requête _ de diffusion Deny pour refuser la demande.

Notes

Pour les appareils qui offrent des fonctionnalités contrôlables par logiciel, telles que l’éjection et le verrouillage, le système envoie généralement un message DBT _ DEVICEREMOVEPENDING pour permettre aux applications et pilotes de périphérique de mettre fin à leur utilisation de l’appareil. Si le système supprime de force un appareil, il ne peut pas envoyer un message DBT _ DEVICEQUERYREMOVE .

Spécifications

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

Voir aussi

DBT _ CONFIGCHANGECANCELED

DBT _ CONFIGCHANGED

DBT _ CUSTOMEVENT

DBT _ DEVICEARRIVAL

DBT _ DEVICEQUERYREMOVE

DBT _ DEVICEQUERYREMOVEFAILED

DBT _ DEVICEREMOVECOMPLETE

DBT _ DEVICEREMOVEPENDING

DBT _ DEVICETYPESPECIFIC

DBT _ DEVNODES _ modifié

DBT _ QUERYCHANGECONFIG

DBT _ USERDEFINED