KLST_DEVINFO Struct Reference

Semi-opaque device information structure of a device list. More...

#include <libusbk.h>

Data Fields
KLST_DEV_COMMON_INFO	Common
	Common usb device information.
INT	DriverID
	Driver id this device element is using.
CHAR	DeviceInterfaceGUID [KLST_STRING_MAX_LEN]
	Device interface GUID.
CHAR	DeviceID [KLST_STRING_MAX_LEN]
	Device instance ID. More...
CHAR	ClassGUID [KLST_STRING_MAX_LEN]
	Class GUID.
CHAR	Mfg [KLST_STRING_MAX_LEN]
	Manufacturer name as specified in the INF file.
CHAR	DeviceDesc [KLST_STRING_MAX_LEN]
	Device description as specified in the INF file.
CHAR	Service [KLST_STRING_MAX_LEN]
	Driver service name.
CHAR	SymbolicLink [KLST_STRING_MAX_LEN]
	Unique identifier.
CHAR	DevicePath [KLST_STRING_MAX_LEN]
	physical device filename used with the Windows CreateFile()
INT	LUsb0FilterIndex
	libusb-win32 filter index id.
BOOL	Connected
	Indicates the devices connection state.
KLST_SYNC_FLAG	SyncFlags
	Synchronization flags. (internal use only)
CHAR	SerialNumber [KLST_STRING_MAX_LEN]
	If the the device is serialized, represents the string value of USB_DEVICE_DESCRIPTOR::iSerialNumber. For Devices without a iSerialNumber, represents the unique InstanceID assigned by Windows.

Detailed Description

Semi-opaque device information structure of a device list.

Attention

This structure is semi-opaque.

Examples:

config-interface.c, hot-plug-monitor.c, load-driver-api.c, open-device.c, pipe-policy-timeout.c, power-policy-suspend.c, show-device.c, xfer-async-loop.c, xfer-async.c, xfer-control.c, xfer-iso-asap.c, xfer-iso.c, xfer-stream.c, and xfer-sync.c.

Field Documentation

CHAR DeviceID[KLST_STRING_MAX_LEN]

Device instance ID.

A Device instance ID has the following format: [enumerator][enumerator-specific-device-ID][instance-specific-ID]

• [enumerator]
  • For USB device, the enumerator is always USB
• [enumerator-specific-device-ID]
  • Contains the vendor and product id (VID_xxxx&PID_xxxx)
  • If present, contains the usbccgp (windows composite device layer) interface number (MI_xx)
• [instance-specific-ID]
  • If the device is composite, contains a unique interface ID generated by Windows.
  • If the device is not composite and has a serial number, contains the devices serial number.
  • If the device does not have a serial number, contains a unique ID generated by Windows.

Examples:

hot-plug-monitor.c, xfer-iso-asap.c, and xfer-iso.c.

---

The documentation for this struct was generated from the following file:

• libusbk.h