Macro WdfDeviceStopIdleWithTag (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

A macro WdfDeviceStopIdleWithTag incrementa a contagem de referência de energia para um objeto de dispositivo de estrutura especificado e atribui o nome do arquivo e o número de linha atuais do driver à referência. A macro também atribui um valor de marca à referência.

Sintaxe

NTSTATUS WdfDeviceStopIdleWithTag(
    _In_ WDFDEVICE Device,
    _In_ BOOLEAN WaitForD0,
    _In_ PVOID Tag
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] WaitForD0

Um valor booliano que indica quando WdfDeviceStopIdleWithTag retornará. Se verdadeiro, ele retornará somente depois que o dispositivo especificado tiver inserido o estado de energia do dispositivo D0. Se FALSE, o método retornará imediatamente.

[in] Tag

Um valor definido pelo driver que a estrutura armazena como uma marca de identificação para a referência de energia.

Valor de retorno

Nenhum

Observações

Se a operação for bem-sucedida, WdfDeviceStopIdleWithTag retornará STATUS_SUCCESS.

Os valores de retorno adicionais incluem:

O método pode retornar outros valores NTSTATUS .

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

Se o driver chamar WdfDeviceStopIdleWithTag para incrementar uma contagem de referência, o driver deverá chamar WdfDeviceResumeIdleWithTag para diminuir a contagem.

Chamar WdfDeviceStopIdleWithTag em vez de WdfDeviceStopIdle fornece informações adicionais (valor da marca, número de linha e nome do arquivo) que você pode exibir nos depuradores da Microsoft. WdfDeviceStopIdleWithTag 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 !wdftagtracker depurador. A extensão do depurador exibe o valor da marca como um ponteiro e uma série de caracteres.

Use !wdfkd.wdfdevice com sinalizadores detalhados e localize o link para !wdftagtracker na saída:

kd> !wdfdevice <handle> f 

Requisitos

Consulte também

depuração de vazamentos de referência de energia no WDF

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle