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)

추가 정보

WdfDeviceInitSetPowerNotPageable