DEV_BROADCAST_PORT_W structure (dbt.h)

Contains information about a modem, serial, or parallel port.

Syntax

typedef struct _DEV_BROADCAST_PORT_W {
  DWORD   dbcp_size;
  DWORD   dbcp_devicetype;
  DWORD   dbcp_reserved;
  wchar_t dbcp_name[1];
} DEV_BROADCAST_PORT_W, *PDEV_BROADCAST_PORT_W;

Members

dbcp_size

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

dbcp_devicetype

Set to DBT_DEVTYP_PORT.

dbcp_reserved

Reserved; do not use.

dbcp_name[1]

A null-terminated string specifying the friendly name of the port or the device connected to the port. Friendly names are intended to help the user quickly and accurately identify the device—for example, "COM1" and "Standard 28800 bps Modem" are considered friendly names.

Remarks

Note

The dbt.h header defines DEV_BROADCAST_PORT 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

WM_DEVICECHANGE