Fungsi WdfUsbInterfaceGetNumEndpoints (wdfusb.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfUsbInterfaceGetNumEndpoints mengembalikan jumlah titik akhir yang terkait dengan pengaturan alternatif yang ditentukan dari antarmuka USB tertentu.

Sintaks

BYTE WdfUsbInterfaceGetNumEndpoints(
  [in] WDFUSBINTERFACE UsbInterface,
  [in] UCHAR           SettingIndex
);

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.

Nilai kembali

Jika indeks yang ditentukan valid, WdfUsbInterfaceGetNumEndpoints mengembalikan jumlah titik akhir yang terkait dengan pengaturan alternatif antarmuka yang ditentukan. Jika tidak, metode mengembalikan nol.

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

Keterangan

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

Contoh

Contoh kode berikut memperoleh jumlah titik akhir untuk pengaturan alternatif 0 dari antarmuka USB yang ditentukan.

BYTE  numEndpoints;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

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

WdfUsbTargetDeviceGetInterface