Função WdfDevStateIsNP (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

O método WdfDevStateIsNP retorna um valor booliano que indica se um estado de energia ou estado de política de energia especificado é um estado não pageable .

Sintaxe

BOOLEAN WdfDevStateIsNP(
  [in] ULONG State
);

Parâmetros

[in] State

Um enumerador com tipo WDF_DEVICE_POWER_STATE ou um enumerador tipo WDF_DEVICE_POWER_POLICY_STATE.

Retornar valor

Se o driver de chamada não estiver atualmente inpálível, o método WdfDevStateIsNP retornará TRUE. Caso contrário, o método retornará FALSE.

Comentários

Para obter o estado atual do computador de estado de energia da estrutura, um driver pode chamar WdfDeviceGetDevicePowerState de dentro de uma função de retorno de chamada de energia ou PnP. Para obter o estado atual do computador de estado da política de energia da estrutura, um driver pode chamar WdfDeviceGetDevicePowerPolicyState de dentro de uma função de retorno de chamada de política de energia. Depois que o driver tiver chamado WdfDeviceGetDevicePowerState ou WdfDeviceGetDevicePowerPolicyState, ele poderá chamar WdfDevStateIsNP para determinar se o estado retornado representa um estado paginável ou não paginável. Se a máquina de estado da estrutura estiver em um estado não paginável, o driver não poderá ser paginável e não deverá executar nenhuma operação que possa fazer com que o sistema operacional acesse o arquivo de paginação. Essas operações incluem acessar arquivos, o registro ou o pool paginado.

Exemplos

O exemplo de código a seguir define o valor não atualizável como TRUE se o computador de estado de energia da estrutura estiver atualmente em um estado não página.

BOOLEAN nonpageable;

nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualquer nível

Confira também

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable