Fungsi WdfUsbInterfaceGetNumEndpoints (wdfusb.h)
[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) |