Condividi tramite


Funzione WdfCollectionRemoveItem (wdfcollection.h)

[Si applica a KMDF e UMDF]

Il metodo WdfCollectionRemoveItem rimuove un oggetto specificato da un insieme di oggetti, in base a un valore di indice specificato.

Sintassi

void WdfCollectionRemoveItem(
  [in] WDFCOLLECTION Collection,
  [in] ULONG         Index
);

Parametri

[in] Collection

Handle per un oggetto raccolta.

[in] Index

Indice in base zero che identifica l'oggetto da rimuovere.

Valore restituito

nessuno

Osservazioni

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

I valori di indice rappresentano l'ordine in cui gli oggetti vengono aggiunti a una raccolta. Un valore di indice pari a zero rappresenta il primo oggetto aggiunto all'insieme, un valore di indice di uno rappresenta il secondo oggetto e così via.

Quando WdfCollectionRemoveItem rimuove un oggetto da un insieme, decrementa il conteggio dei riferimenti dell'oggetto.

Per altre informazioni sulle raccolte oggetti, vedere Raccolte oggetti Framework

Esempio

Per un esempio di codice che usa WdfCollectionRemoveItem, vedere WdfCollectionGetFirstItem.

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

WdfCollectionRemove