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 e o número de linha atuais do driver à 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 verdadeiro, 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.
Valor de retorno
Nenhum
Observações
Se a operação for bem-sucedida, WdfDeviceStopIdleWithTag retornará STATUS_SUCCESS.
Os valores de retorno adicionais incluem:
| Código de retorno | Descrição |
|---|---|
| STATUS_PENDING | O dispositivo está sendo habilitado 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 .
Uma verificação de bug ocorre se o driver fornece 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 !wdftagtracker depurador. 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 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 | Consulte a seção Comentários. |
| regras de conformidade de DDI | DriverCreate, KmdfIrql, KmdfIrql2 |