Funzione WdfCollectionGetCount (wdfcollection.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfCollectionGetCount restituisce il numero di oggetti attualmente presenti in un insieme di oggetti.

Sintassi

ULONG WdfCollectionGetCount(
  [in] WDFCOLLECTION Collection
);

Parametri

[in] Collection

Handle di un insieme.

Valore restituito

WdfCollectionGetCount restituisce il numero di oggetti presenti nell'insieme.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo dei bug di sistema.

Osservazioni

Per altre informazioni sugli insiemi di oggetti, vedere Framework Object Collections.

Esempi

Nell'esempio di codice seguente viene ottenuto il numero di oggetti in una raccolta specificata e viene utilizzato il numero per esaminare tutti gli oggetti dell'insieme.

ULONG count;

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfcollection.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WdfCollectionGetItem

Condividi tramite