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
);

Parámetros

handle [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.

Observaciones

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

Un controlador puede llamar a WdfObjectDereference solo si anteriormente 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 referencias de objetos, vea Ciclo de vida del objeto framework.

Ejemplos

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

WdfObjectDereference(Object); 

Requisitos

Consulte también

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference