Função WdfDevStateIsNP (wdfdevice.h)
[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 |