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 atual do driver e o número de linha à 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 TRUE, 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.

Retornar valor

Nenhum

Comentários

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

Os valores retornados adicionais incluem:

Código de retorno	Descrição
STATUS_PENDING	O dispositivo está sendo ligado de forma assíncrona.
STATUS_INVALID_DEVICE_STATE	O driver não é o proprietário da política de energia do dispositivo.
STATUS_POWER_STATE_INVALID	Ocorreu uma falha no dispositivo e o dispositivo não pode inserir seu estado de energia D0.

O método pode retornar outros valores NTSTATUS.

Um bug marcar ocorrerá se o driver fornecer 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 depurador !wdftagtracker . 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 ativados e localize o link para !wdftagtracker na saída:

kd> !wdfdevice <handle> f 

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.15
Versão mínima do UMDF	2.15
Cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Consulte a seção Observações.
Regras de conformidade de DDI	DriverCreate, KmdfIrql, KmdfIrql2

Confira também

Depurando vazamentos de referência de energia no WDF

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle