Funzione WdfCollectionRemove (wdfcollection.h)

[Si applica a KMDF e UMDF]

Il metodo WdfCollectionRemove rimuove un oggetto da un insieme di oggetti specificato.

Sintassi

void WdfCollectionRemove(
  [in] WDFCOLLECTION Collection,
  [in] WDFOBJECT     Item
);

[in] Collection

Handle di un insieme.

[in] Item

Handle per l'oggetto framework che verrà rimosso dall'insieme.

Nessuno

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

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

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

Nell'esempio di codice seguente viene rimosso un oggetto specificato da una raccolta di oggetti specificata.

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

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)