USB_BUS_STATISTICS_0結構 (usbuser.h)

  • 發行項

USB_BUS_STATISTICS_0 結構會與IOCTL_USB_USER_REQUEST I/O 控制要求搭配使用，以擷取總線統計數據。

語法

typedef struct _USB_BUS_STATISTICS_0 {
  ULONG         DeviceCount;
  LARGE_INTEGER CurrentSystemTime;
  ULONG         CurrentUsbFrame;
  ULONG         BulkBytes;
  ULONG         IsoBytes;
  ULONG         InterruptBytes;
  ULONG         ControlDataBytes;
  ULONG         PciInterruptCount;
  ULONG         HardResetCount;
  ULONG         WorkerSignalCount;
  ULONG         CommonBufferBytes;
  ULONG         WorkerIdleTimeMs;
  BOOLEAN       RootHubEnabled;
  UCHAR         RootHubDevicePowerState;
  UCHAR         Unused;
  UCHAR         NameIndex;
} USB_BUS_STATISTICS_0, *PUSB_BUS_STATISTICS_0;

成員

DeviceCount

公交車上的裝置數目。

CurrentSystemTime

目前的系統時間。

CurrentUsbFrame

目前 USB 框架的數目。

BulkBytes

大量傳輸數據的數量，以位元組為單位。

IsoBytes

等時數據的數量，以位元組為單位。

InterruptBytes

中斷數據的數量，以位元組為單位。

ControlDataBytes

控制數據的數量，以位元組為單位。

PciInterruptCount

中斷數據的數量，以位元組為單位。

HardResetCount

已發生的硬式總線重設數目。

WorkerSignalCount

背景工作線程已發出工作完成訊號的次數。

CommonBufferBytes

一般緩衝區所傳輸的位元組數目。

WorkerIdleTimeMs

背景工作線程已閑置的時間量，以毫秒為單位。

RootHubEnabled

布爾值，指出是否啟用根中樞。 如果為 TRUE，則會啟用根中樞。 如果 為 FALSE，則會停用根中樞。

RootHubDevicePowerState

根中樞裝置的電源狀態。 此成員可以有下列任何值：

值 意義
0 D0 電源狀態
1 D1 電源狀態
2 D2 電源狀態
3 D3 電源狀態

Unused

如果此成員為 1，則總線為使用中。 如果為 0，則總線為非使用中。

NameIndex

用來產生中樞 PDO 符號連結名稱的索引。 符號連結的格式是USBPDO-n，其中n 是NameIndex中的值。

備註

USB_BUS_STATISTICS_0結構會與USBUSER_BUS_STATISTICS_0使用者模式要求搭配使用。 如需此要求的描述，請參閱 IOCTL_USB_USER_REQUEST。

在 Windows 8 中，此要求會順利完成。 不過，從基礎 USB 3.0 驅動程式堆棧擷取的值不會反映實際的總線統計數據。

規格需求

需求 值
標頭 usbuser.h (包含 Usbuser.h)

另請參閱

IOCTL_USB_USER_REQUEST

USB 結構