Depurando vazamentos de referência de energia no WDF

Artigo
10/20/2023

Quando um driver WDF (Estruturas de Driver do Windows) chama WdfDeviceStopIdle, a estrutura incrementa a contagem de referência de energia do dispositivo. Cada chamada bem-sucedida para WdfDeviceStopIdle deve ser correspondida por uma chamada para WdfDeviceResumeIdle para diminuir a contagem de referência de energia.

Começando no KMDF (Kernel-Mode Driver Framework) 1.15 e User-Mode Driver Framework (UMDF) 2.15, você pode monitorar o uso da referência de energia usando as extensões de depurador !wdfkd.wdfdevice e !wdfkd.wdftagtracker . Essa funcionalidade é desabilitada por padrão por motivos de desempenho, portanto, você precisa ativá-la com o aplicativo WdfVerifier ou editando manualmente a chave de serviço do driver.

WdfVerifier

Abra a lista de configurações do driver e clique com o botão direito do mouse na configuração TrackPower . Escolha a opção apropriada para seu cenário.

Ponta Evite capturar rastreamentos de pilha em caminhos de código críticos ao desempenho.

Captura de tela da configuração do controle de referências de energia no WdfVerifier.

Editando o Registro

Você também pode ativar o suporte do Verificador e o acompanhamento de referência de energia editando a chave de serviço do driver.

Para um driver KMDF:

HKLM\SYSTEM\ControlSet001\Services\<Driver Service Name>\Parameters\Wdf

Para um driver UMDF:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF\Services\<Driver Service Name>\Parameters\Wdf

(REG_DWORD) VerifierOn = 0x1
(REG_DWORD) TrackPower = 0x0 (disabled)
                       = 0x1 (capture tick count, file name, line number)
                       = 0x2 (capture tick count, file name, line number, and stack traces)

Código do driver

Os drivers chamam WdfDeviceStopIdle e WdfDeviceResumeIdle para gerenciar o estado de energia de trabalho do dispositivo da seguinte maneira:

//
// Take power reference
//
status = WdfDeviceStopIdle(device, FALSE);
if (NT_SUCCESS(status)) {
    //
    // Release power reference
    //
    WdfDeviceResumeIdle(device);
}

Depuração com WdfKd

Para exibir as referências de energia feitas no dispositivo, bem como um rastreador de marcas que mostra o histórico de referência, use !wdfkd.wdfdevice com sinalizadores detalhados:

kd> !wdfkd.wdfdevice 0x6d939790 ff
Power references: 0 !wdftagtracker 0x9ea030a8

Chamar o !wdfkd.wdftagtracker mostra o histórico de referência de energia do dispositivo:

kd> !wdftagtracker 0x9ea030a8
Reference and Release History:
# (showing most recent first; refcount is approximate in multi-threaded scenarios)

## 3 entries, history depth is 25

(--) 0 ref: Tag '....' at Time 0x1331e ticks
##      path\to\your\driver\code.c @ 374

(++) 1 refs: Tag '....' at Time 0x1331e ticks
##      path\to\your\driver\code.c @ 372

(++) Initial Tag '....' at Time 0x12c9a ticks

Especificando uma marca

Opcionalmente, especifique um nome de marca para facilitar a identificação de referências de energia específicas. Para fazer isso, use WdfDeviceStopIdleWithTag e WdfDeviceResumeIdleWithTag:

status = WdfDeviceStopIdleWithTag(device, FALSE, (PVOID)'oyeH');
if (NT_SUCCESS(status)) {
    WdfDeviceResumeIdleWithTag(device, (PVOID)'oyeH');
}

Saída de exemplo do !wdftagtracker correspondente:

(--) 0 ref: Tag 'Heyo' at Time 0x24e40 ticks
##      path\to\your\driver\code.c @ 374

(++) 1 refs: Tag 'Heyo' at Time 0x24e40 ticks
##      path\to\your\driver\code.c @ 372

(++) Initial Tag '....' at Time 0x12c9a ticks

Compartilhar via