DBT_CONFIGCHANGED event

The system broadcasts the DBT_CONFIGCHANGED device event to indicate that the current configuration has changed, due to a dock or undock. An application or driver that stores data in the registry under the HKEY_CURRENT_CONFIG key should update the data.

To broadcast this device event, the system uses the WM_DEVICECHANGE message with wParam set to DBT_CONFIGCHANGED and lParam set to zero.

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

Parameters

hwnd

A handle to a window.

uMsg

The WM_DEVICECHANGE message identifier.

wParam

Set to DBT_CONFIGCHANGED.

lParam

Set to zero.

Return value

Return TRUE.

Requirements

Requirement	Value
Minimum supported client	Windows XP
Minimum supported server	Windows Server 2003
Header	Dbt.h

See also

Device Events

Device Management Events

WM_DEVICECHANGE