WdfUsbTargetPipeGetIoTarget-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbTargetPipeGetIoTarget-Methode gibt ein Handle an das E/A-Zielobjekt zurück, das einem angegebenen USB-Pipe zugeordnet ist.
Syntax
WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
[in] WDFUSBPIPE Pipe
);
Parameter
[in] Pipe
Ein Handle zu einem Framework-Pipeobjekt, das durch Aufrufen WdfUsbInterfaceGetConfiguredPipeabgerufen wurde.
Rückgabewert
WdfUsbTargetPipeGetIoTarget gibt ein Handle an das E/A-Zielobjekt zurück, das dem angegebenen Pipeobjekt zugeordnet ist.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Weitere Informationen zur WdfUsbTargetPipeGetIoTarget Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Das folgende Codebeispiel zeigt, wie ein 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- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfusb.h (include Wdfusb.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | Beliebige Ebene |
| DDI-Complianceregeln | DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf) |