Macro WdfObjectDereference
[Si applica a KMDF e UMDF]
La macro WdfObjectDereference decrementa il conteggio dei riferimenti per un oggetto framework specificato.
Sintassi
VOID WdfObjectDereference(
[in] WDFOBJECT Handle
);
Parametri
Handle [in]
Handle per un oggetto framework.
Valore restituito
Nessuno.
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Se il conteggio dei riferimenti dell'oggetto diventa zero, l'oggetto potrebbe essere eliminato prima che WdfObjectDereference restituisca .
Un driver può chiamare WdfObjectDereference solo se in precedenza ha chiamato WdfObjectReference.
Anziché chiamare WdfObjectDereference, un driver può chiamare WdfObjectDereferenceWithTag o WdfObjectDereferenceActual.
Per altre informazioni sui conteggi dei riferimenti agli oggetti, vedere Ciclo di vita dell'oggetto Framework.
Esempio
L'esempio di codice seguente decrementa il numero di riferimenti di un oggetto.
WdfObjectDereference(Object);
Requisiti
Piattaforma di destinazione |
Universale |
Versione KMDF minima |
1.0 |
Versione UMDF minima |
2,0 |
Intestazione |
Wdfobject.h (includere Wdf.h) |
Libreria |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |
Regole di conformità DDI |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |