Macro WdfObjectDereferenceWithTag

[Se aplica a KMDF y UMDF]

La macro WdfObjectDereferenceWithTag disminuye el recuento de referencias de un objeto de marco especificado y asigna el nombre de archivo actual del controlador y el número de línea a la referencia. Esta macro también asigna un valor de etiqueta a la referencia.

Sintaxis

VOID WdfObjectDereferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

Parámetros

Identificador [in]
Identificador de un objeto de marco.

Etiqueta [in]
Valor definido por el controlador que identifica una referencia de objeto. El valor de etiqueta debe coincidir con un valor de etiqueta que el controlador proporcionó anteriormente a WdfObjectReferenceWithTag.

Valor devuelto

Ninguno.

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

Comentarios

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

Llamar a WdfObjectDereferenceActual o WdfObjectDereferenceWithTag en lugar de WdfObjectDereference proporciona información adicional (cadena de etiqueta, número de línea y nombre de archivo) a los depuradores de Microsoft. WdfObjectDereferenceActual permite al controlador especificar el número de línea y el nombre de archivo, mientras que WdfObjectDereferenceWithTag usa el número de línea y el nombre de archivo actuales del controlador.

Puede ver los valores de etiqueta, número de línea y nombre de archivo mediante la extensión del depurador !wdftagtracker . La extensión del depurador muestra el valor de etiqueta como puntero y una serie de caracteres. Para obtener más información sobre las extensiones del depurador, consulte Depuración de un controlador KMDF.

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 disminuye el recuento de referencias de un objeto y se asigna un valor de etiqueta a la referencia.

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

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

Consulte también

WdfObjectDereference

WdfObjectReferenceWithTag