Função WdfObjectDereferenceActual (wdfobject.h)

[Aplica-se a KMDF e UMDF]

O método WdfObjectDereferenceActual decrementa a contagem de referência para um objeto de estrutura especificado e atribui um valor de marca, um número de linha e um nome de arquivo à referência.

Sintaxe

void WdfObjectDereferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in, optional] PCCH      File
);

Parâmetros

[in] Handle

Um identificador para um objeto de estrutura.

[in, optional] Tag

Um valor definido pelo driver que identifica uma referência de objeto. O valor da marca deve corresponder a um valor de marca que o driver forneceu anteriormente para WdfObjectReferenceActual.

[in] Line

Um valor numérico que representa um número de linha em um arquivo de origem do driver.

[in, optional] File

Um ponteiro para uma cadeia de caracteres constante terminada em nulo que representa o nome de um arquivo de origem do driver. Esse parâmetro é opcional e pode ser NULL.

Valor retornado

Nenhum

Comentários

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

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

Chamar WdfObjectDereferenceActual ou WdfObjectDereferenceWithTag em vez de WdfObjectDereference fornece informações adicionais (cadeia de caracteres de marca, número de linha e nome do arquivo) para os depuradores da Microsoft. O WdfObjectDereferenceActual permite que o driver especifique o número de 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 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 de depurador, consulte Depurando um driver KMDF.

Para obter mais informações sobre contagens de referência de objeto e as regras de limpeza de uma hierarquia de objetos de estrutura, consulte o Ciclo de Vida do Objeto Framework.

Exemplos

O exemplo de código a seguir decrementa a contagem de referência de um objeto e atribui um valor de marca, um número de linha e um nome de arquivo à referência.

WdfObjectDereferenceActual(
                           object,
                           pTag,
                           line,
                           FILE_NAME
                           );

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 (include Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf)

Confira também

WdfObjectDereference

WdfObjectReferenceActual