Compartilhar via


Macro WdfDeviceResumeIdleWithTag (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O WdfDeviceResumeIdleWithTag decrementa 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

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.

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

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 e localize o link para !wdftagtracker na saída:

kd> !wdfdevice <handle> f 

Requisitos

Requisito Valor
da 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

Consulte também

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

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag