Macro WdfObjectReferenceWithTag

[Se aplica a KMDF y UMDF]

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

Sintaxis

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

Parámetros

handle [in]
Identificador de un objeto de marco.

etiqueta [in]
Valor definido por el controlador que el marco almacena como una etiqueta de identificación para la referencia de objeto.

Valor devuelto

Ninguno.

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

Observaciones

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

Llamar a WdfObjectReferenceActual o WdfObjectReferenceWithTag en lugar de WdfObjectReference proporciona información adicional (valor de etiqueta, número de línea y nombre de archivo) a los depuradores de Microsoft. WdfObjectReferenceActual permite al controlador especificar el número de línea y el nombre de archivo, mientras que WdfObjectReferenceWithTag 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 de depurador de !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 referencias de objetos, vea Ciclo de vida del objeto framework.

Ejemplos

En el ejemplo de código siguiente se incrementa el recuento de referencias de un objeto y se asigna un valor de etiqueta a la referencia.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

Requisitos

Consulte también

WdfObjectReference