WdfDeviceInitSetPowerPageable 함수(wdfdevice.h)
[KMDF에만 적용]
WdfDeviceInitSetPowerPageable 메서드는 시스템이 절전 상태와 작동 중(S0) 상태 간에 전환되는 동안 드라이버가 페이징 가능한 데이터에 액세스할 수 있어야 한다는 것을 전원 관리자에게 알릴 수 있습니다.
통사론
void WdfDeviceInitSetPowerPageable(
[in] PWDFDEVICE_INIT DeviceInit
);
매개 변수
[in] DeviceInit
WDFDEVICE_INIT 구조체에 대한 호출자 제공 포인터입니다.
반환 값
없음
발언
함수 드라이버 또는 버스 드라이버가 WdfDeviceInitSetPowerPageable 호출하는 경우 드라이버의 디바이스가 저전력 상태가 들어가거나 작업 상태반환할 때 시스템에서 페이징 파일의 디바이스가 작동 중(D0) 상태인지 확인합니다. 이렇게 하면 드라이버가 디바이스의 전원 전환 중에 파일, 레지스트리 및 페이징 풀에 액세스할 수 있습니다.
기본적으로 프레임워크는 함수 드라이버에 대한 페이지 가능한 데이터에 액세스할 수 있도록 합니다. 이 프레임워크는 버스 드라이버가 WdfDeviceInitSetPowerPageable 또는 자식 디바이스에 대해 WdfDeviceInitSetPowerNotPageable 호출하지 않는 한 버스 드라이버가 열거하는 각 자식 디바이스에 대해 부모 디바이스 설정을 사용합니다. 자식 디바이스에 대해 WdfDeviceInitSetPowerPageable 호출하는 버스 드라이버를 작성하는 경우 자식 디바이스 스택의 어떤 드라이버도 WdfDeviceInitSetPowerNotPageable호출할 수 없습니다.
필터 드라이버에서 WdfDeviceInitSetPowerPageable 또는 WdfDeviceInitSetPowerNotPageable 호출해도 아무 효과가 없습니다. 프레임워크는 다음 하위 드라이버가 지정하는 설정을 사용합니다.
대부분의 드라이버는 WdfDeviceInitSetPowerPageable 또는 WdfDeviceInitSetPowerNotPageable 호출할 필요가 없습니다. 대신 프레임워크에서 드라이버에 적합한 기본 설정을 사용하도록 해야 합니다. 그러나 드라이버가 전원 전환 중에(예: 스토리지 스택 또는 비디오 스택) 페이저블 데이터에 액세스하지 않아야 하는 드라이버 스택의 일부이거나 스토리지 또는 비디오 디바이스일 수 있는 디바이스를 열거하는 버스 드라이버인 경우 드라이버가 WdfDeviceInitSetPowerNotPageable 호출해야 합니다.
드라이버가 WdfDeviceInitSetPowerInrush 호출하는 경우 WdfDeviceInitSetPowerPageable호출해서는 안 됩니다.
드라이버가 WdfDeviceCreate 호출하기 전에WdfDeviceInitSetPowerPageable 호출해야 합니다.
WdfDeviceCreate호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기참조하세요.
예제
다음 코드 예제에서는 시스템이 절전 상태와 작업(S0) 상태 간에 전환되는 동안 드라이버가 페이징 가능한 데이터에 액세스할 수 있어야 한다고 Power Manager에 알릴 수 있습니다.
WdfDeviceInitSetPowerPageable(DeviceInit);
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfdevice.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql (kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |