PUSB_BUSIFFN_QUERY_BUS_INFORMATION funzione di callback (usbbusif.h)

Articolo
02/26/2024

La routine QueryBusInformation ottiene informazioni sul bus.

Sintassi

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

Parametri

[in] unnamedParam1

Handle restituito nel membro BusContext della struttura USB_BUS_INTERFACE_USBDI_V0 da una richiesta di IRP_MN_QUERY_INTERFACE .

[out, optional] unnamedParam2

Specifica la lunghezza dei dati di output.

[in, out] unnamedParam3

Puntatore a un buffer che riceve le informazioni sul bus richieste.

[out] unnamedParam4

In input, lunghezza del buffer specificato da BusInformationBuffer. In output, lunghezza dei dati di output.

[in] unnamedParam5

Specifica il livello di informazioni da restituire. Se il livello è 0, la funzione restituisce la larghezza di banda totale e la larghezza di banda totale utilizzata in bit al secondo. Se level è 1, la funzione restituisce il nome simbolico del controller in Unicode, oltre alla larghezza di banda totale e alla larghezza di banda totale utilizzata.

Valore restituito

QueryBusInformation restituisce uno dei valori seguenti:

Codice restituito Descrizione

STATUS_SUCCESS La chiamata è stata completata correttamente.

STATUS_BUFFER_TOO_SMALL Il buffer era troppo piccolo. Questo codice di errore viene restituito in due casi:

Ogni volta che livello == 0, questo codice di errore viene restituito se le dimensioni del buffer puntate da BusInformationBuffer sono inferiori alle dimensioni della struttura USB_BUS_INFORMATION_LEVEL_0 .

Ogni volta che level == 1, questo codice di errore viene restituito se la dimensione del buffer puntata da BusInformationBuffer minore delle dimensioni della struttura USB_BUS_INFORMATION_LEVEL_1 .

Codice restituito	Descrizione
`STATUS_SUCCESS`	La chiamata è stata completata correttamente.
`STATUS_BUFFER_TOO_SMALL`	Il buffer era troppo piccolo. Questo codice di errore viene restituito in due casi: Ogni volta che livello == 0, questo codice di errore viene restituito se le dimensioni del buffer puntate da BusInformationBuffer sono inferiori alle dimensioni della struttura USB_BUS_INFORMATION_LEVEL_0 . Ogni volta che level == 1, questo codice di errore viene restituito se la dimensione del buffer puntata da BusInformationBuffer minore delle dimensioni della struttura USB_BUS_INFORMATION_LEVEL_1 .

Commenti

Le informazioni esatte restituite da questa routine dipendono dal valore del parametro Level . Questa routine sostituisce la funzione di libreria USBD_QueryBusInformation fornita da usbd.sys .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	usbbusif.h (include Usbbusif.h)
IRQL	< = DISPATCH_LEVEL