Macro WdfObjectReferenceWithTag

[Aplica-se a KMDF e UMDF]

A macro WdfObjectReferenceWithTag incrementa a contagem de referência para um objeto de estrutura especificado e atribui o nome de arquivo atual do driver e o número da linha à referência. A macro também atribui um valor de tag à referência.

Sintaxe

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

Parâmetros

Manipular [in]
Um identificador para um objeto de estrutura.

Tag [in]
Um valor definido pelo driver que a estrutura armazena como uma marca de identificação para a referência de objeto.

Valor de retorno

Nenhum.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Se o driver chamar WdfObjectReferenceWithTag para incrementar uma contagem de referência, o driver deverá chamar WdfObjectDereferenceWithTag para diminuir a contagem.

Chamar WdfObjectReferenceActual ou WdfObjectReferenceWithTag em vez de WdfObjectReference fornece informações adicionais (valor da tag, número da linha e nome do arquivo) aos depuradores da Microsoft. WdfObjectReferenceActual permite que o driver especifique o número da linha e o nome do arquivo, enquanto WdfObjectReferenceWithTag usa o número de linha e o nome do arquivo atuais do driver.

Você pode exibir os valores de tag, número de linha e nome de arquivo usando a extensão !wdftagtracker depurador. A extensão do depurador exibe o valor da tag como um ponteiro e uma série de caracteres. Para obter mais informações sobre extensões de depurador, consulte Depurando um driver KMDF.

Para obter mais informações sobre contagens de referência de objeto, consulte Framework Object Life Cycle.

Exemplos

O exemplo de código a seguir incrementa a contagem de referência de um objeto e atribui um valor de marca à referência.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

Requerimentos

Plataforma de destino	Universal
Versão mínima do KMDF	1.0
Versão mínima UMDF	2.0
Cabeçalho	Wdfobject.h (inclui Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= NÍVEL_DE_DESPACHO

Ver também

WdfObjectReference