WdfUsbTargetPipeGetIoTarget, fonction (wdfusb.h)
[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) |