Depurando vazamentos de referência de energia no WDF

Quando um driver WDF (Windows Driver Frameworks) chama WdfDeviceStopIdle, a estrutura aumenta 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.

A partir do Kernel-Mode Driver Framework (KMDF) 1.15 e do User-Mode Driver Framework (UMDF) 2.15, pode-se monitorizar o uso da referência de energia usando as extensões de depuração !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 seu driver e clique com o botão direito do mouse na configuração TrackPower . Escolha a opção apropriada para o seu cenário.

Dica Evite capturar rastreamentos de pilha em caminhos de código críticos para o desempenho.

Editando o Registro

Você também pode ativar o suporte ao Verificador e o rastreamento de referências 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 condutor

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 tags que mostra o histórico de referência, use !wdfkd.wdfdevice com sinalizadores detalhados:

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

Ao 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 tag

Opcionalmente, especifique um nome de tag 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 correspondente de amostra !wdftagtracker:

(--) 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