Fungsi WdfUsbTargetPipeWdmGetPipeHandle (wdfusb.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfUsbTargetPipeWdmGetPipeHandle mengembalikan handel USBD_PIPE_HANDLE-typed yang terkait dengan objek pipa kerangka kerja tertentu.

Sintaks

USBD_PIPE_HANDLE WdfUsbTargetPipeWdmGetPipeHandle(
  [in] WDFUSBPIPE UsbPipe
);

Parameter

[in] UsbPipe

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

Nilai kembali

WdfUsbTargetPipeWdmGetPipeHandle mengembalikan handel USBD_PIPE_HANDLE-typed.

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

Keterangan

Driver berbasis kerangka kerja perlu mendapatkan handel USBD_PIPE_HANDLE-typed hanya jika membuat URB yang memerlukan handel pipa.

Driver dapat memanggil metode WdfUsbTargetPipeWdmGetPipeHandle setelah disebut WdfUsbTargetDeviceSelectConfig. Handel yang diketik USBD_PIPE_HANDLE yang dikembalikan WdfUsbTargetPipeWdmGetPipeHandle valid hingga driver memanggil WdfUsbTargetDeviceSelectConfig lagi, driver memanggil WdfUsbInterfaceSelectSetting, atau objek pipa kerangka kerja dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek pipa kerangka kerja, dan jika objek dihapus sebelum driver memanggil WdfUsbTargetDeviceSelectConfig lagi atau memanggil WdfUsbInterfaceSelectSetting, handel valid hingga fungsi EvtCleanupCallback objek kembali.

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

Contoh

Contoh kode berikut mendapatkan handel yang ditik USBD_PIPE_HANDLE untuk pipa tertentu.

USBD_PIPE_HANDLE  usbdPipeHandle;

usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(UsbPipe);

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Header wdfusb.h (termasuk Wdfusb.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

URB

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceSelectConfig