Condividi tramite


Funzione WdfCollectionRemove (wdfcollection.h)

[Si applica a KMDF e UMDF]

Il metodo WdfCollectionRemove rimuove un oggetto da una raccolta di oggetti specificata.

Sintassi

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

Parametri

[in] Collection

Handle per un oggetto raccolta.

[in] Item

Handle per l'oggetto framework che verrà rimosso dalla raccolta.

Valore restituito

nessuno

Osservazioni

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 sulle raccolte di oggetti, vedere Framework Object Collections.

Esempio

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

WdfCollectionRemove(
                    hCollection,
                    hObject
                    );

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 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)

Vedi anche

WdfCollectionRemoveItem