Compartilhar via


Macro WdfDeviceResumeIdleWithTag (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

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

Sintaxe

void WdfDeviceResumeIdleWithTag(
  [in]  Device,
  [in]  Tag
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[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

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 WdfDeviceResumeIdleWithTag retorne.

Chamar WdfDeviceResumeIdleWithTag em vez de WdfDeviceResumeIdle fornece informações adicionais (valor da marca, número de linha e nome do arquivo) que você pode exibir nos depuradores da Microsoft. WdfDeviceResumeIdleWithTag 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 de depurador !wdfkd.wdftagtracker .

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 <= DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate, KmdfIrql, KmdfIrql2

Confira também

Depurando vazamentos de referência de energia no WDF

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag