Funzione WdfCollectionGetCount (wdfcollection.h)

Articolo
02/26/2024

[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 per un oggetto raccolta.

Valore restituito

WdfCollectionGetCount restituisce il numero di oggetti presenti nell'insieme.

Un controllo del bug di sistema si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Per altre informazioni sulle raccolte di oggetti, vedere Raccolte oggetti Framework.

Esempio

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

ULONG count;

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfcollection.h (includere Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfCollectionGetItem

Condividi tramite