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) |