USB_BUS_STATISTICS_0-Struktur (usbuser.h)

Die USB_BUS_STATISTICS_0-Struktur wird mit der IOCTL_USB_USER_REQUEST E/A-Steuerungsanforderung zum Abrufen von Busstatistiken verwendet.

Syntax

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;

Member

DeviceCount

Die Anzahl der Geräte im Bus.

CurrentSystemTime

Die aktuelle Systemzeit.

CurrentUsbFrame

Die Nummer des aktuellen USB-Frames.

BulkBytes

Die Menge der Massenübertragungsdaten in Bytes.

IsoBytes

Die Menge isochroner Daten in Bytes.

InterruptBytes

Die Menge der Interruptdaten in Bytes.

ControlDataBytes

Die Menge der Steuerungsdaten in Bytes.

PciInterruptCount

Die Menge der Interruptdaten in Bytes.

HardResetCount

Die Anzahl der hard bus resets, die aufgetreten sind.

WorkerSignalCount

Die Häufigkeit, mit der ein Workerthread den Abschluss einer Aufgabe signalisiert hat.

CommonBufferBytes

Die Anzahl der Bytes, die vom allgemeinen Puffer übertragen werden.

WorkerIdleTimeMs

Die Zeitspanne in Millisekunden, für die Sich Workerthreads im Leerlauf befinden.

RootHubEnabled

Ein boolescher Wert, der angibt, ob der Stammhub aktiviert ist. Bei TRUE ist der Stammhub aktiviert. Bei FALSE ist der Stammhub deaktiviert.

RootHubDevicePowerState

Der Energiestatus der Stammhubgeräte. Dieser Member kann einen der folgenden Werte aufweisen:

Wert	Bedeutung
0	D0 Energiezustand
1	D1-Energiezustand
2	D2-Energiezustand
3	D3-Energiezustand

Unused

Wenn dieser Member 1 ist, ist der Bus aktiv. Wenn 0, ist der Bus inaktiv.

NameIndex

Der Index, der verwendet wird, um einen symbolischen Linknamen für das Hub-PDO zu generieren. Dieses Format der symbolischen Verknüpfung ist USBPDO-n, wobei n der Wert in NameIndex ist.

Hinweise

Die USB_BUS_STATISTICS_0-Struktur wird mit der USBUSER_BUS_STATISTICS_0 Benutzermodusanforderung verwendet. Eine Beschreibung dieser Anforderung finden Sie unter IOCTL_USB_USER_REQUEST.

In Windows 8 wird diese Anforderung erfolgreich abgeschlossen. Die vom zugrunde liegenden USB 3.0-Treiberstapel abgerufenen Werte spiegeln jedoch nicht die tatsächliche Busstatistik wider.

Anforderungen

Anforderung	Wert
Header	usbuser.h (include Usbuser.h)

Weitere Informationen

IOCTL_USB_USER_REQUEST

USB-Strukturen