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 vers un objet de canal d’infrastructure obtenu en appelant WdfUsbInterfaceGetConfiguredPipe.
Valeur de retour
WdfUsbTargetPipeGetIoTarget retourne un handle à l’objet cible d’E/S associé à l’objet de canal spécifié.
Une vérification de bogue 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;
}
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfusb.h (include Wdfusb.h) |
| bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | N’importe quel niveau |
| règles de conformité DDI | DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf) |