WdfUsbTargetPipeGetIoTarget-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbTargetPipeGetIoTarget-Methode gibt ein Handle an das E/A-Zielobjekt zurück, das einer angegebenen USB-Pipe zugeordnet ist.
Syntax
WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
[in] WDFUSBPIPE Pipe
);
Parameter
[in] Pipe
Ein Handle für ein Framework-Pipeobjekt, das durch aufrufen von WdfUsbInterfaceGetConfiguredPipe abgerufen wurde.
Rückgabewert
WdfUsbTargetPipeGetIoTarget gibt ein Handle für das E/A-Zielobjekt zurück, das dem angegebenen Pipeobjekt zugeordnet ist.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zur WdfUsbTargetPipeGetIoTarget-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Das folgende Codebeispiel zeigt, wie eine EvtDeviceD0Entry-Rückruffunktion einen kontinuierlichen Reader für eine USB-Pipe starten kann.
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;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfusb.h (einschließlich Wdfusb.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | Beliebige Ebene |
| DDI-Complianceregeln | DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf) |