Funzione WdfCollectionGetCount (wdfcollection.h)

  • Articolo

[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