Fungsi WdfCollectionGetItem (wdfcollection.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfCollectionGetItem mengembalikan handel ke objek yang terkandung dalam koleksi objek tertentu dan terkait dengan nilai indeks tertentu.
Sintaks
WDFOBJECT WdfCollectionGetItem(
[in] WDFCOLLECTION Collection,
[in] ULONG Index
);
Parameter
[in] Collection
Handel ke objek koleksi.
[in] Index
Nilai indeks berbasis nol yang mengidentifikasi objek dalam koleksi.
Nilai kembali
WdfCollectionGetItem mengembalikan handel objek kerangka kerja, atau NULL jika nilai Indeks tidak valid.
Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.
Keterangan
Nilai indeks mewakili urutan di mana objek ditambahkan ke koleksi. Nilai indeks nol mewakili objek pertama dalam koleksi, nilai indeks satu mewakili objek kedua, dan sebagainya, seperti daftar tertaut. Ketika driver menghapus item i dari koleksi, item i+1 menjadi item i.
Untuk informasi selengkapnya tentang koleksi objek, lihat Koleksi Objek Kerangka Kerja.
Contoh
Untuk contoh kode yang menggunakan WdfCollectionGetItem, lihat WdfCollectionGetCount.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Versi UMDF minimum | 2.0 |
| Header | wdfcollection.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |