Condividi tramite

PUSB_BUSIFFN_QUERY_BUS_INFORMATION funzione di callback (usbbusif.h)

  • Articolo

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 .

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

Vedi anche