Macro WdfObjectDereference

[Se aplica a KMDF y UMDF]

La macro WdfObjectDereference disminuye el recuento de referencias de un objeto de marco especificado.

Sintaxis

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Identificador [in]
Identificador de un objeto de marco.

Ninguno.

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

Si el recuento de referencias del objeto se convierte en cero, es posible que el objeto se elimine antes de que WdfObjectDereference devuelva.

Un controlador puede llamar a WdfObjectDereference solo si anteriormente se ha llamado a WdfObjectReference.

En lugar de llamar a WdfObjectDereference, un controlador puede llamar a WdfObjectDereferenceWithTag o WdfObjectDereferenceActual.

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

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

WdfObjectDereference(Object);

Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	Wdfobject.h (incluir Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest