_URB_CONTROL_GET_INTERFACE_REQUEST structure (usb.h)

  • Article

La structure _URB_CONTROL_GET_INTERFACE_REQUEST est utilisée par les pilotes clients USB pour récupérer le paramètre d’interface de remplacement actuel pour une interface dans la configuration actuelle.

Syntaxe

struct _URB_CONTROL_GET_INTERFACE_REQUEST {
  struct _URB_HEADER   Hdr;
  PVOID                Reserved;
  ULONG                Reserved0;
  ULONG                TransferBufferLength;
  PVOID                TransferBuffer;
  PMDL                 TransferBufferMDL;
  struct _URB          *UrbLink;
  struct _URB_HCD_AREA hca;
  UCHAR                Reserved1[4];
  USHORT               Interface;
  USHORT               Reserved2;
};

Membres

Hdr

Pointeur vers une structure de _URB_HEADER qui spécifie les informations d’en-tête URB. Hdr.Function doit être URB_FUNCTION_GET_INTERFACE, et Hdr.Length doit être égal à sizeof(_URB_CONTROL_GET_INTERFACE_REQUEST).

Reserved

Réservé. Ne pas utiliser.

Reserved0

Réservé. Ne pas utiliser.

TransferBufferLength

Doit être égal à 1. Ce membre spécifie la longueur, en octets, de la mémoire tampon spécifiée dans TransferBuffer ou décrite dans TransferBufferMDL. Le pilote du contrôleur hôte retourne le nombre d’octets envoyés ou lus à partir du canal dans ce membre.

TransferBuffer

Pointeur vers une mémoire tampon résidente pour le transfert ou a la valeur NULL si une MDL est fournie dans TransferBufferMDL. Le pilote de bus retourne un octet unique spécifiant l’index de l’autre paramètre actuel pour l’interface.

TransferBufferMDL

Pointeur vers une MDL qui décrit une mémoire tampon résidente ou a la valeur NULL si une mémoire tampon est fournie dans TransferBuffer. Le pilote de bus retourne un octet unique spécifiant l’index de l’autre paramètre actuel pour l’interface. Cette MDL doit être allouée à partir d’un pool non paginé.

UrbLink

Réservé. Ne pas utiliser.

hca

Réservé. Ne pas utiliser.

Reserved1[4]

Réservé. Ne pas utiliser.

Interface

Spécifie l’index défini par l’appareil du descripteur d’interface en cours de récupération.

Reserved2

Réservé. Ne pas utiliser.

Remarques

Les membres réservés de cette structure doivent être traités comme opaques et sont réservés à l’utilisation du système.

Configuration requise

Condition requise Valeur
En-tête usb.h (incluez Usb.h)

Voir aussi

URB

USB Structures

_URB_HEADER