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, la lunghezza del buffer specificato da BusInformationBuffer. Nell'output la lunghezza dei dati di output.

[in] unnamedParam5

Specifica il livello di informazioni da restituire. Se Level è 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 a cui puntano BusInformationBuffer è minore delle dimensioni della struttura USB_BUS_INFORMATION_LEVEL_0.

Ogni volta che il livello == 1, questo codice di errore viene restituito se la dimensione del buffer a cui punta BusInformationBuffer minore delle dimensioni della struttura USB_BUS_INFORMATION_LEVEL_1.

Osservazioni

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.

Fabbisogno

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

Vedere anche