Fungsi WdfUsbTargetPipeGetIoTarget (wdfusb.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfUsbTargetPipeGetIoTarget mengembalikan handel ke objek target I/O yang terkait dengan pipa USB tertentu.

Sintaks

WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
  [in] WDFUSBPIPE Pipe
);

Parameter

[in] Pipe

Handel ke objek pipa kerangka kerja yang diperoleh dengan memanggil WdfUsbInterfaceGetConfiguredPipe.

Nilai kembali

WdfUsbTargetPipeGetIoTarget mengembalikan handel ke objek target I/O yang terkait dengan objek pipa yang ditentukan.

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya tentang metode WdfUsbTargetPipeGetIoTarget dan target I/O USB, lihat Target I/O USB.

Contoh

Contoh kode berikut menunjukkan bagaimana fungsi panggilan balik EvtDeviceD0Entry dapat memulai pembaca berkelanjutan untuk pipa 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;
}

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfusb.h (termasuk Wdfusb.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Tingkat apa pun
Aturan kepatuhan DDI DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf)

Lihat juga

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget