USBD_BuildRegisterCompositeDevice, fonction (usbdlib.h)

  • Article

La routine USBD_BuildRegisterCompositeDevice est appelée par le pilote d’un périphérique multi-fonction USB (pilote composite) pour initialiser une structure REGISTER_COMPOSITE_DEVICE avec les informations requises pour inscrire le pilote auprès de la pile de pilotes USB.

La routine est appelée par un pilote qui remplace le pilote composite fourni par Microsoft, Usbccgp.sys.

Syntaxe

void USBD_BuildRegisterCompositeDevice(
  [in]  USBD_HANDLE                   USBDHandle,
  [in]  COMPOSITE_DEVICE_CAPABILITIES CapabilityFlags,
  [in]  ULONG                         FunctionCount,
  [out] PREGISTER_COMPOSITE_DEVICE    RegisterCompositeDevice
);

Paramètres

[in] USBDHandle

Un handle USBD récupéré lors d’un appel précédent à la routine USBD_CreateHandle .

[in] CapabilityFlags

Structure de COMPOSITE_DEVICE_CAPABILITIES allouée par l’appelant qui indique les fonctionnalités prises en charge par le pilote composite. Pour instance, pour indiquer que le pilote composite prend en charge la suspension de fonction, définissez le membre CapabilityFunctionSuspend de COMPOSITE_DEVICE_CAPABILITIES sur 1.

[in] FunctionCount

Nombre d’objets de périphérique physique (PPO) à créer par le pilote parent. La valeur FunctionCount ne peut pas dépasser 255.

[out] RegisterCompositeDevice

Pointeur vers une structure de REGISTER_COMPOSITE_DEVICE allouée par l’appelant. Une fois l’opération terminée, la structure est remplie avec les informations d’inscription spécifiées. Pour inscrire le pilote composite, envoyez le IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE demande d’E/S et transmettez la structure renseignée.

Valeur de retour

None

Configuration requise

Condition requise Valeur
Client minimal pris en charge Nécessite WDK pour Windows 8. Cible Windows Vista et les versions ultérieures du système d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête usbdlib.h
Bibliothèque Usbdex.lib
IRQL < = DISPATCH_LEVEL

Voir aussi

IOCTL_INTERNAL_USB_REGISTER_COMPOSITE_DEVICE

REGISTER_COMPOSITE_DEVICE