Fungsi WdfCollectionGetCount (wdfcollection.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfCollectionGetCount mengembalikan jumlah objek yang saat ini berada dalam koleksi objek.

Sintaks

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Parameter

[in] Collection

Handel ke objek koleksi.

Nilai kembali

WdfCollectionGetCount mengembalikan jumlah objek yang ada dalam koleksi.

Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.

Keterangan

Untuk informasi selengkapnya tentang koleksi objek, lihat Koleksi Objek Kerangka Kerja.

Contoh

Contoh kode berikut mendapatkan jumlah objek dalam koleksi tertentu dan menggunakan angka untuk memeriksa semua objek dalam koleksi.

ULONG count;

count = WdfCollectionGetCount(CollectionHandle);
for (i = 0; i < count; i++) {
    ObjectHandle = WdfCollectionGetItem(
                                        CollectionHandle,
                                        i
                                        );
    // 
    // Perform object-specific operations.
    // 
}

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)

Lihat juga

WdfCollectionGetItem