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)

Siehe auch

WdfUsbInterfaceGetConfiguredPipe-

WdfUsbTargetDeviceGetIoTarget