DEV_BROADCAST_PORT_A structure (dbt.h)

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

Syntax

typedef struct _DEV_BROADCAST_PORT_A {
  DWORD dbcp_size;
  DWORD dbcp_devicetype;
  DWORD dbcp_reserved;
  char  dbcp_name[1];
} DEV_BROADCAST_PORT_A, *PDEV_BROADCAST_PORT_A;

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