PUSB_BUSIFFN_QUERY_BUS_INFORMATION Rückruffunktion (usbbusif.h)

Artikel
02/26/2024

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 im BusContext-Element der USB_BUS_INTERFACE_USBDI_V0-Struktur von einer IRP_MN_QUERY_INTERFACE-Anforderung zurückgegeben wird.

[out, optional] unnamedParam2

Gibt die Länge der Ausgabedaten an.

[in, out] unnamedParam3

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

[out] unnamedParam4

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

[in] unnamedParam5

Gibt die Zurückzugebende Informationsebene an. Wenn Level 0 ist, gibt die Funktion die Gesamtbandbreite und die insgesamt verbrauchte Bandbreite in Bits pro Sekunde zurück. Wenn Level 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 Aufruf wurde erfolgreich abgeschlossen.

STATUS_BUFFER_TOO_SMALL Der Puffer war zu klein. Dieser Fehlercode wird in zwei Fällen zurückgegeben:

Immer 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.

Immer bei 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 ist.

Rückgabecode	Beschreibung
`STATUS_SUCCESS`	Der Aufruf wurde erfolgreich abgeschlossen.
`STATUS_BUFFER_TOO_SMALL`	Der Puffer war zu klein. Dieser Fehlercode wird in zwei Fällen zurückgegeben: Immer 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. Immer bei 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 ist.

Hinweise

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

Anforderungen

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

Share via