Freigeben über

PUSB_BUSIFFN_QUERY_BUS_INFORMATION Rückruffunktion (usbbusif.h)

  • Artikel

Die QueryBusInformation Routine ruft Informationen zum Bus ab.

Syntax

typedef NTSTATUS
  (USB_BUSIFFN *PUSB_BUSIFFN_QUERY_BUS_INFORMATION) (
    IN PVOID,
    IN ULONG,
    IN OUT PVOID,
    IN OUT PULONG,
    OUT PULONG
  );

Parameter

[in] unnamedParam1

Handle, das in der BusContext- Member der USB_BUS_INTERFACE_USBDI_V0 Struktur durch eine IRP_MN_QUERY_INTERFACE Anforderung zurückgegeben wird.

[out, optional] unnamedParam2

Gibt die Länge der Ausgabedaten an.

[in, out] unnamedParam3

Zeigen Sie auf einen Puffer, der die angeforderten Businformationen empfängt.

[out] unnamedParam4

Bei eingabe, die Länge des durch BusInformationBuffer angegebenen Puffers. Bei der Ausgabe die Länge der Ausgabedaten.

[in] unnamedParam5

Gibt die Ebene der zurückzugebenden Informationen an. Wenn Level 0 ist, gibt die Funktion die Gesamtbandbreite und die gesamte verbrauchte Bandbreite in Bits pro Sekunde zurück. Wenn Ebene 1 ist, gibt die Funktion den symbolischen Namen des Controllers in Unicode sowie die Gesamtbandbreite und die gesamte verbrauchte Bandbreite zurück.

Rückgabewert

QueryBusInformation- gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Der Anruf wurde erfolgreich abgeschlossen.
STATUS_BUFFER_TOO_SMALL Der Puffer war zu klein. Dieser Fehlercode wird in zwei Fällen zurückgegeben:

Wenn Ebene == 0, wird dieser Fehlercode zurückgegeben, wenn die Größe des Puffers, auf den BusInformationBuffer verweist, kleiner als die Größe der USB_BUS_INFORMATION_LEVEL_0 Struktur ist.

Wann immer Ebene == 1, wird dieser Fehlercode zurückgegeben, wenn die Größe des Puffers, auf den BusInformationBuffer verweist, kleiner als die Größe der USB_BUS_INFORMATION_LEVEL_1 Struktur.

Bemerkungen

Die genauen Informationen, die von dieser Routine zurückgegeben werden, hängen vom Wert des parameters Level ab. Diese Routine ersetzt die USBD_QueryBusInformation Bibliotheksfunktion, die von usbd.sysbereitgestellt wird.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- usbbusif.h (include Usbbusif.h)
IRQL- < = DISPATCH_LEVEL

Siehe auch