Fungsi WdfUsbTargetDeviceWdmGetConfigurationHandle (wdfusb.h)

[Hanya berlaku untuk KMDF]

Metode WdfUsbTargetDeviceWdmGetConfigurationHandle mengembalikan handel jenis USBD_CONFIGURATION_HANDLE yang terkait dengan konfigurasi perangkat USB tertentu saat ini.

Sintaks

USBD_CONFIGURATION_HANDLE WdfUsbTargetDeviceWdmGetConfigurationHandle(
  [in] WDFUSBDEVICE UsbDevice
);

Parameter

[in] UsbDevice

Handel ke objek perangkat USB yang diperoleh dari panggilan sebelumnya ke WdfUsbTargetDeviceCreateWithParameters.

Nilai kembali

Jika driver telah memilih konfigurasi untuk perangkat, WdfUsbTargetDeviceWdmGetConfigurationHandle mengembalikan handel perangkat yang USBD_CONFIGURATION_HANDLE ketik. Jika tidak, metode mengembalikan NULL.

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

Keterangan

Driver berbasis kerangka kerja perlu mendapatkan handel yang diketik USBD_CONFIGURATION_HANDLE hanya jika membuat URB yang berisi struktur _URB_SELECT_INTERFACE .

Driver dapat memanggil WdfUsbTargetDeviceWdmGetConfigurationHandle setelah disebut WdfUsbTargetDeviceSelectConfig. Handel USBD_CONFIGURATION_HANDLE-typed yang dikembalikan WdfUsbTargetDeviceWdmGetConfigurationHandle valid hingga driver memanggil WdfUsbTargetDeviceSelectConfig lagi atau objek perangkat USB dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek perangkat USB, dan jika objek dihapus sebelum driver memanggil WdfUsbTargetDeviceSelectConfig lagi, handel valid hingga fungsi EvtCleanupCallback objek kembali.

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

Contoh

Contoh kode berikut mendapatkan handel ke konfigurasi perangkat USB tertentu saat ini.

USBD_CONFIGURATION_HANDLE deviceConfigHdl;

deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);

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

WdfUsbTargetDeviceSelectConfig

_URB_SELECT_INTERFACE