Condividi tramite


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

WdfObjectReferenceActual

WdfObjectReferenceWithTag