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 à 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.
Retornar valor
Nenhum
Comentários
Um bug marcar ocorrerá se o driver fornecer 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) 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 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 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, um número de linha e um nome de arquivo à referência.
WdfObjectDereferenceActual(
object,
pTag,
line,
FILE_NAME
);
Requisitos
| Requisito | Valor |
|---|---|
| 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 |
| Regras de conformidade de DDI | DriverCreate(kmdf) |