Edit

DBT_CUSTOMEVENT event

  • Article

The system sends the DBT_CUSTOMEVENT device event when a driver-defined custom event has occurred.

To broadcast this device event, the system uses the WM_DEVICECHANGE message with wParam set to DBT_CUSTOMEVENT and lParam set as described following.

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_CUSTOMEVENT.

lParam

A pointer to a structure identifying the device. The structure consists of an event-independent header, followed by event-dependent members that describe the device. To use this structure, treat the structure as a DEV_BROADCAST_HDR structure, then check its dbch_devicetype member to determine the device type.

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

DEV_BROADCAST_HDR

WM_DEVICECHANGE