Macro WdfObjectReference

[Se aplica a KMDF y UMDF]

La macro WdfObjectReference incrementa el recuento de referencias de un objeto de marco especificado.

Sintaxis

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

Parámetros

Identificador [in]
Identificador de un objeto de marco.

Valor devuelto

Ninguno.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Si el controlador llama a WdfObjectReference para incrementar un recuento de referencias, el controlador debe llamar a WdfObjectDereference para disminuir el recuento.

En lugar de llamar a WdfObjectReference, un controlador puede llamar a WdfObjectReferenceWithTag o WdfObjectReferenceActual.

Para obtener más información sobre los recuentos de referencia de objetos, vea Ciclo de vida de objetos de marco.

Ejemplos

En el ejemplo de código siguiente se incrementa el recuento de referencias de un objeto.

WdfObjectReference(Object); 

Requisitos

Plataforma de destino

Universal

Versión mínima de KMDF

1.0

Versión mínima de UMDF

2.0

Encabezado

Wdfobject.h (incluya Wdf.h)

Biblioteca

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

IRQL

<= DISPATCH_LEVEL

Reglas de cumplimiento de DDI

DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA

Consulte también

WdfObjectReferenceActual

WdfObjectReferenceWithTag