Função WdfObjectDereferenceActual (wdfobject.h)
[Aplica-se a KMDF e UMDF]
O método WdfObjectDereferenceActual diminui 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 aode 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 de retorno
Nenhum
Observações
Uma verificação de bug ocorre 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 de WdfObjectDereferenceActual retornar.
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. 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 !wdftagtracker depurador. 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 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 marca, um número de linha e um nome de arquivo à referência.
WdfObjectDereferenceActual(
object,
pTag,
line,
FILE_NAME
);