Macro WdfObjectDereferenceWithTag

[Aplica-se ao KMDF e UMDF]

A macro WdfObjectDereferenceWithTag decrementa a contagem de referência para um objeto de estrutura especificado e atribui o nome de arquivo atual do driver e o número de linha à referência. Essa macro também atribui um valor de marca à referência.

Sintaxe

VOID WdfObjectDereferenceWithTag(
  [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 identifica uma referência de objeto. O valor da marca deve corresponder a um valor de marca fornecido anteriormente pelo driver para WdfObjectReferenceWithTag.

Valor retornado

Nenhum.

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

Comentários

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 de marca, número de linha e nome de arquivo) para depurador da Microsoft. WdfObjectDereferenceActual permite que o driver especifique o número de linha e o nome do arquivo, enquanto WdfObjectDereferenceWithTag 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 Ciclo de vida do objeto framework.

Exemplos

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

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

Requisitos

Plataforma de destino

Universal

Versão mínima do KMDF

1,0

Versão mínima do UMDF

2,0

Cabeçalho

Wdfobject.h (inclua Wdf.h)

Biblioteca

Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)

IRQL

<= DISPATCH_LEVEL

Confira também

WdfObjectDereference

WdfObjectReferenceWithTag