WdfUsbTargetPipeGetIoTarget, fonction (wdfusb.h)

  • Article

[S’applique à KMDF et UMDF]

La méthode WdfUsbTargetPipeGetIoTarget retourne un handle à l’objet cible d’E/S associé à un canal USB spécifié.

Syntaxe

WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
  [in] WDFUSBPIPE Pipe
);

Paramètres

[in] Pipe

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

Valeur retournée

WdfUsbTargetPipeGetIoTarget retourne un handle à l’objet cible d’E/S associé à l’objet de canal spécifié.

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

Remarques

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

Exemples

L’exemple de code suivant montre comment une fonction de rappel EvtDeviceD0Entry peut démarrer un lecteur continu pour un canal USB.

NTSTATUS
MyEvtDeviceD0Entry(
    IN  WDFDEVICE Device,
    IN  WDF_POWER_DEVICE_STATE PreviousState
)
{
    PDEVICE_CONTEXT  pDeviceContext;
    NTSTATUS  status;

    pDeviceContext = GetMyDeviceContext(Device);

    status = WdfIoTargetStart(WdfUsbTargetPipeGetIoTarget(pDeviceContext->InterruptPipe));

    return status;
}

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfusb.h (inclure Wdfusb.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL N’importe quel niveau
Règles de conformité DDI DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf)

Voir aussi

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget