Funzione WdfCollectionRemoveItem (wdfcollection.h)

Articolo
02/07/2025

[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 di un insieme.

[in] Index

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

Valore restituito

Nessuno

Osservazioni

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

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 pari a 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 di oggetti, vedere Framework Object Collections

Esempi

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

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

WdfCollectionRemove

Condividi tramite