Macro WdfObjectDereferenceWithTag

[Aplica-se a KMDF e UMDF]

A macro WdfObjectDereferenceWithTag diminui 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. Essa macro também atribui um valor de tag à referência.

Sintaxe

VOID WdfObjectDereferenceWithTag(
  [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 identifica uma referência de objeto. O valor da tag deve corresponder a um valor de tag que o driver forneceu anteriormente ao WdfObjectReferenceWithTag.

Valor de retorno

Nenhum.

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

Observações

Se a contagem de referência do objeto se tornar zero, o objeto poderá ser excluído antes que WdfObjectDereferenceWithTag retorne.

Chamar WdfObjectDereferenceActual ou WdfObjectDereferenceWithTag em vez de WdfObjectDereference fornece informações adicionais (cadeia de caracteres, número de linha e nome de arquivo) aos depuradores da Microsoft. WdfObjectDereferenceActual permite que o driver especifique o número da linha e o nome do arquivo, enquanto WdfObjectDereferenceWithTag 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 diminui a contagem de referência de um objeto e atribui um valor de tag à referência.

WdfObjectDereferenceWithTag(
                            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

WdfObjectDereference

WdfObjectReferenceWithTag