DEV_BROADCAST_DEVICEINTERFACE_A structure (dbt.h)

Contains information about a class of devices.

Syntax

typedef struct _DEV_BROADCAST_DEVICEINTERFACE_A {
  DWORD dbcc_size;
  DWORD dbcc_devicetype;
  DWORD dbcc_reserved;
  GUID  dbcc_classguid;
  char  dbcc_name[1];
} DEV_BROADCAST_DEVICEINTERFACE_A, *PDEV_BROADCAST_DEVICEINTERFACE_A;

Members

dbcc_size

The size of this structure, in bytes. This is the size of the members plus the actual length of the dbcc_name string (the null character is accounted for by the declaration of dbcc_name as a one-character array.)

dbcc_devicetype

Set to DBT_DEVTYP_DEVICEINTERFACE.

dbcc_reserved

Reserved; do not use.

dbcc_classguid

The GUID for the interface device class.

dbcc_name[1]

A null-terminated string that specifies the name of the device.

When this structure is returned to a window through the WM_DEVICECHANGE message, the dbcc_name string is converted to ANSI as appropriate. Services always receive a Unicode string, whether they call RegisterDeviceNotificationW or RegisterDeviceNotificationA.

Remarks

Note

The dbt.h header defines DEV_BROADCAST_DEVICEINTERFACE as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

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

See also

DEV_BROADCAST_HDR

Device Management Structures

RegisterDeviceNotification

WM_DEVICECHANGE