Fonction WdfUsbTargetPipeWdmGetPipeHandle (wdfusb.h)

[S’applique uniquement à KMDF]

La méthode WdfUsbTargetPipeWdmGetPipeHandle retourne le handle de type USBD_PIPE_HANDLE associé à un objet de canal d’infrastructure spécifié.

Syntaxe

USBD_PIPE_HANDLE WdfUsbTargetPipeWdmGetPipeHandle(
  [in] WDFUSBPIPE UsbPipe
);

Paramètres

[in] UsbPipe

Handle d’un objet de canal d’infrastructure obtenu en appelant WdfUsbInterfaceGetConfiguredPipe.

Valeur retournée

WdfUsbTargetPipeWdmGetPipeHandle retourne un handle de type USBD_PIPE_HANDLE.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Un pilote basé sur l’infrastructure doit obtenir un handle de type USBD_PIPE_HANDLE uniquement s’il crée un URB qui nécessite un handle de canal.

Le pilote peut appeler la méthode WdfUsbTargetPipeWdmGetPipeHandle après avoir appelé WdfUsbTargetDeviceSelectConfig. Le handle de type USBD_PIPE_HANDLE que WdfUsbTargetPipeWdmGetPipeHandle retourne est valide jusqu’à ce que le pilote appelle À nouveau WdfUsbTargetDeviceSelectConfig , que le pilote appelle WdfUsbInterfaceSelectSetting ou que l’objet de canal d’infrastructure soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de canal d’infrastructure, et si l’objet est supprimé avant que le pilote n’appelle à nouveau WdfUsbTargetDeviceSelectConfig ou appelle WdfUsbInterfaceSelectSetting, le handle est valide jusqu’à ce que la fonction EvtCleanupCallback de l’objet soit retournée.

Pour plus d’informations sur la méthode WdfUsbTargetPipeWdmGetPipeHandle et les cibles d’E/S USB, consultez Cibles d’E/S USB.

Exemples

L’exemple de code suivant obtient le handle de type USBD_PIPE_HANDLE pour un canal spécifié.

USBD_PIPE_HANDLE  usbdPipeHandle;

usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(UsbPipe);

Configuration requise

Voir aussi

URB

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceSelectConfig