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 do arquivo atual do driver e o número de linha à referência. A macro também atribui um valor de marca à referência.

Sintaxe

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

Parâmetros

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

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

Valor retornado

Nenhum.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

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 marca, número de linha e nome do arquivo) aos depuradores da Microsoft. WdfObjectReferenceActual permite que o driver especifique o número de linha e o nome do arquivo, enquanto WdfObjectReferenceWithTag usa o número de linha atual do driver e o nome do arquivo.

Você pode exibir os valores de marca, número de linha e nome de arquivo usando a extensão do depurador !wdftagtracker . A extensão do depurador exibe o valor da marca como um ponteiro e uma série de caracteres. Para obter mais informações sobre extensões do 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
                          );

Requisitos

Plataforma de destino	Universal
Versão mínima do KMDF	1.0
Versão mínima do UMDF	2,0
parâmetro	Wdfobject.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL

Confira também

WdfObjectReference