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) |