WdfDevStateIsNP 함수(wdfdevice.h)
[KMDF 및 UMDF에 적용]
WdfDevStateIsNP 메서드는 지정된 전원 상태 또는 전원 정책 상태가 페이지를 매기지 않는 상태인지 여부를 나타내는 부울 값을 반환합니다.
구문
BOOLEAN WdfDevStateIsNP(
[in] ULONG State
);
매개 변수
[in] State
WDF_DEVICE_POWER_STATE 형식의 열거자 또는 WDF_DEVICE_POWER_POLICY_STATE 형식의 열거자입니다.
반환 값
호출 드라이버가 현재 페이지를 처리할 수 없는 경우 WdfDevStateIsNP 메서드는 TRUE를 반환합니다. 그렇지 않으면 메서드가 FALSE를 반환 합니다.
설명
프레임워크의 전원 상태 컴퓨터의 현재 상태를 가져오기 위해 드라이버는 PnP 또는 파워 콜백 함수 내에서 WdfDeviceGetDevicePowerState 를 호출할 수 있습니다. 프레임워크의 전원 정책 상태 컴퓨터의 현재 상태를 가져오기 위해 드라이버는 전원 정책 콜백 함수 내에서 WdfDeviceGetDevicePowerPolicyState 를 호출할 수 있습니다. 드라이버가 WdfDeviceGetDevicePowerState 또는 WdfDeviceGetDevicePowerPolicyState를 호출한 후 WdfDevStateIsNP 를 호출하여 반환된 상태가 페이징 가능 또는 비페이지 가능 상태를 나타내는지 확인할 수 있습니다. 프레임워크의 상태 컴퓨터가 페이징할 수 없는 상태인 경우 드라이버는 페이징할 수 없으며 운영 체제가 페이징 파일에 액세스하도록 할 수 있는 작업을 수행해서는 안 됩니다. 이러한 작업에는 파일, 레지스트리 또는 페이징 풀에 액세스하는 작업이 포함됩니다.
예제
다음 코드 예제에서는 프레임워크의 전원 상태 컴퓨터가 현재 페이지할 수 없는 상태인 경우 페이지할 수 없는 값을 TRUE 로 설정합니다.
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfdevice.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
| IRQL | 모든 수준 |