Condividi tramite


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.

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

Osservazioni:

Se il conteggio dei riferimenti dell'oggetto diventa zero, l'oggetto potrebbe essere eliminato prima che venga restituito WdfObjectDereference.

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.

Esempi

Nell'esempio di codice seguente viene decrementato il conteggio dei riferimenti di un oggetto.

WdfObjectDereference(Object); 

Requisiti

Piattaforma di destinazione

universale

Versione minima di KMDF

1.0

Versione minima di UMDF

2.0

Header

Wdfobject.h (include Wdf.h)

Biblioteca

Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)

IRQL

<= LIVELLO_DI_INVIO

Regole di conformità DDI

DriverCreare, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

Vedere anche

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference