PUSB_BUSIFFN_QUERY_BUS_INFORMATION fonction de rappel (usbbusif.h)

La routine QueryBusInformation obtient des informations sur le bus.

Syntaxe

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

Paramètres

[in] unnamedParam1

Handle retourné dans le membre BusContext de la structure USB_BUS_INTERFACE_USBDI_V0 par une requête IRP_MN_QUERY_INTERFACE.

[out, optional] unnamedParam2

Spécifie la longueur des données de sortie.

[in, out] unnamedParam3

Pointeur vers une mémoire tampon qui reçoit les informations de bus demandées.

[out] unnamedParam4

Lors de l’entrée, la longueur de la mémoire tampon spécifiée par BusInformationBuffer. En sortie, longueur des données de sortie.

[in] unnamedParam5

Spécifie le niveau d’informations à retourner. Si Level a la valeur 0, la fonction retourne la bande passante totale et la bande passante totale consommée en bits par seconde. Si Level a la valeur 1, la fonction retourne le nom symbolique du contrôleur en Unicode, en plus de la bande passante totale et de la bande passante totale consommée.

Valeur retournée

QueryBusInformation retourne l’une des valeurs suivantes :

Code de retour	Description
STATUS_SUCCESS	L'appel s'est terminé avec succès.
STATUS_BUFFER_TOO_SMALL	La mémoire tampon était trop petite. Ce code d’erreur est retourné dans deux cas : Chaque fois que Level == 0, ce code d’erreur est retourné si la taille de la mémoire tampon pointée par BusInformationBuffer est inférieure à la taille de la structure USB_BUS_INFORMATION_LEVEL_0 . Chaque fois que Level == 1, ce code d’erreur est retourné si la taille de la mémoire tampon pointée par BusInformationBuffer est inférieure à la taille de la structure USB_BUS_INFORMATION_LEVEL_1 .

Remarques

Les informations exactes retournées par cette routine dépendent de la valeur du paramètre Level . Cette routine remplace la fonction de bibliothèque USBD_QueryBusInformation fournie par usbd.sys.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	usbbusif.h (inclure Usbbusif.h)
IRQL	< = DISPATCH_LEVEL

Voir aussi

• USB_BUS_INFORMATION_LEVEL_0
• USB_BUS_INFORMATION_LEVEL_1
• USB_BUS_INTERFACE_USBDI_V0