Macro WdfObjectReference
[Si applica a KMDF e UMDF]
La macro WdfObjectReference incrementa il conteggio dei riferimenti per un oggetto framework specificato.
Sintassi
VOID WdfObjectReference(
[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 driver chiama WdfObjectReference per aumentare un numero di riferimenti, il driver deve chiamare WdfObjectDereference per decrementare il conteggio.
Anziché chiamare WdfObjectReference, un driver può chiamare WdfObjectReferenceWithTag o WdfObjectReferenceActual.
Per altre informazioni sui conteggi dei riferimenti agli oggetti, vedere Ciclo di vita dell'oggetto Framework.
Esempio
Nell'esempio di codice seguente viene incrementato il conteggio dei riferimenti di un oggetto.
WdfObjectReference(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 |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per