WdfUsbTargetPipeGetIoTarget-Funktion (wdfusb.h)

  • Artikel

[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)

Weitere Informationen

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget