Fungsi WdfUsbInterfaceGetDescriptor (wdfusb.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfUsbInterfaceGetDescriptor mengambil deskriptor antarmuka USB yang terkait dengan pengaturan alternatif tertentu dari antarmuka USB tertentu.

Sintaks

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Parameter

[in] UsbInterface

Handel ke objek antarmuka USB yang diperoleh dengan memanggil WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Nilai indeks yang mengidentifikasi pengaturan alternatif untuk antarmuka. Untuk informasi selengkapnya tentang pengaturan alternatif, lihat spesifikasi USB.

[out] InterfaceDescriptor

Penunjuk ke struktur USB_INTERFACE_DESCRIPTOR yang dialokasikan pemanggil yang diisi kerangka kerja.

Nilai kembali

Tidak ada

Keterangan

Jika nilai SettingIndex tidak valid, struktur USB_INTERFACE_DESCRIPTOR dapat menerima data yang tidak valid.

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

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

Contoh

Contoh kode berikut mendapatkan indeks pengaturan alternatif untuk antarmuka USB tertentu. Kemudian, contoh mendapatkan deskriptor antarmuka USB yang mewakili pengaturan alternatif antarmuka USB saat ini.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

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	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Lihat juga

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface

Bagikan melalui