Freigeben über


WM_DEVICECHANGE Nachricht

Benachrichtigt eine Anwendung über eine Änderung der Hardwarekonfiguration eines Geräts oder computers.

Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion .

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

Parameter

hwnd

Ein Handle für das Fenster.

uMsg

Der WM_DEVICECHANGE-Bezeichner .

wParam

Das aufgetretene Ereignis. Dieser Parameter kann einer der folgenden Werte aus der Headerdatei Dbt.h sein.

Wert Bedeutung

DBT_DEVNODES_CHANGED0x0007
Ein Gerät wurde dem System hinzugefügt oder daraus entfernt.

DBT_QUERYCHANGECONFIG0x0017
Es wird die Berechtigung zum Ändern der aktuellen Konfiguration (Andocken oder Abdocken) angefordert.

DBT_CONFIGCHANGED0x0018
Die aktuelle Konfiguration hat sich aufgrund eines Docks oder Abdockens geändert.

DBT_CONFIGCHANGECANCELED0x0019
Eine Anforderung zum Ändern der aktuellen Konfiguration (Dock oder Abdocken) wurde abgebrochen.

DBT_DEVICEARRIVAL0x8000
Ein Gerät oder ein Medienteil wurde eingefügt und ist jetzt verfügbar.

DBT_DEVICEQUERYREMOVE0x8001
Die Berechtigung zum Entfernen eines Geräts oder eines Medienteils wird angefordert. Jede Anwendung kann diese Anforderung ablehnen und die Entfernung abbrechen.

DBT_DEVICEQUERYREMOVEFAILED0x8002
Eine Anforderung zum Entfernen eines Geräts oder eines Medienteils wurde abgebrochen.

DBT_DEVICEREMOVEPENDING0x8003
Ein Gerät oder ein Medienteil wird entfernt. Kann nicht verweigert werden.

DBT_DEVICEREMOVECOMPLETE0x8004
Ein Gerät oder ein Medienteil wurde entfernt.

DBT_DEVICETYPESPECIFIC0x8005
Ein gerätespezifisches Ereignis ist aufgetreten.

DBT_CUSTOMEVENT0x8006
Ein benutzerdefiniertes Ereignis ist aufgetreten.

DBT_USERDEFINED0xffff
Die Bedeutung dieser Nachricht ist benutzerdefinierte.

lParam

Ein Zeiger auf eine Struktur, die ereignisspezifische Daten enthält. Das Format hängt vom Wert des wParam-Parameters ab. Weitere Informationen finden Sie in der Dokumentation zu jedem Ereignis.

Rückgabewert

Geben Sie TRUE zurück, um die Anforderung zu gewähren.

Geben Sie BROADCAST_QUERY_DENY zurück, um die Anforderung zu verweigern.

Bemerkungen

Für Geräte, die softwarekontrollierbare Funktionen wie Auswurf und Sperren bieten, sendet das System in der Regel eine DBT_DEVICEREMOVEPENDING-Nachricht , damit Anwendungen und Gerätetreiber ihre Verwendung des Geräts ordnungsgemäß beenden können. Wenn das System ein Gerät zwangsweise entfernt, sendet es vor diesem Vorgang möglicherweise keine DBT_DEVICEQUERYREMOVE Nachricht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Header
Winuser.h (schließen Sie Windows.h oder Dbt.h ein)

Siehe auch

DBT_CONFIGCHANGECANCELED

DBT_CONFIGCHANGED

DBT_CUSTOMEVENT

DBT_DEVICEARRIVAL

DBT_DEVICEQUERYREMOVE

DBT_DEVICEQUERYREMOVEFAILED

DBT_DEVICEREMOVECOMPLETE

DBT_DEVICEREMOVEPENDING

DBT_DEVICETYPESPECIFIC

DBT_DEVNODES_CHANGED

DBT_QUERYCHANGECONFIG

DBT_USERDEFINED