Fungsi WdfUsbInterfaceGetDescriptor (wdfusb.h)

  • Artikel

[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