PDXGK_POWER_NOTIFICATION 콜백 함수(d3dkmthk.h)
그래픽 디바이스가 디바이스 전원 상태 전환을 진행한다는 알림을 제공하는 콜백입니다.
구문
PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;
void PdxgkPowerNotification(
PVOID GraphicsDeviceHandle,
DEVICE_POWER_STATE NewGrfxPowerState,
BOOLEAN PreNotification,
PVOID PrivateHandle
)
{...}
매개 변수
GraphicsDeviceHandle
그래픽 디바이스에 대한 콜백을 만들 때 제공해야 하는 불투명 핸들입니다.
NewGrfxPowerState
설정 중인 새 그래픽 전원 상태를 나타내는 DEVICE_POWER_STATE 값입니다.
PreNotification
알림을 제공해야 하는지 여부를 나타내는 부울 값입니다.
PrivateHandle
콜백에 제공되는 불투명 핸들입니다. 이 핸들은 전역적으로 고유해야 하므로 호출 드라이버의 PDO 또는 FDO에 대한 포인터를 사용해야 합니다.
반환 값
없음
설명
이 콜백은 PASSIVE_LEVEL. 드라이버는 새 전원 상태가 PowerDeviceD3인 경우에만 작업의 서비스를 완료하기 위해 차단할 수 있습니다. 이 경우 전체 디바이스 전원 상태 전환의 완료를 차단할 수 있으며 전원 감시 버그 검사 발생할 수 있으므로 호출을 적시에 완료해야 합니다. 새 상태가 PowerDeviceD0인 경우 드라이버는 차단해서는 안됩니다. PowerDeviceD3으로 전환할 때 전환이 중간에 취소되지 않는다고 가정하면 "pre" 및 "post" 알림이 모두 제공됩니다. PowerDeviceD0으로 이동하면 "게시물" 알림만 제공됩니다. 이 콜백 처리기는 원하는 경우 SetSharedPowerComponentStateCb 그래픽 콜백을 호출할 수 있습니다. 이 처리기에서는 그래픽 커널에 대한 다른 콜백이 허용되지 않습니다.
중요
초기 그래픽 전원 상태는 IOCTL 출력에 제공되지만, 등록하는 동안 그래픽 디바이스가 전원 상태 전환을 겪고 있을 수 있으므로 원래 상태의 IOCTL 호출 및 구문 분석과 관련하여 뮤텍스를 획득해야 하며 이 콜백 함수에서 동일한 뮤텍스를 획득해야 합니다. 이렇게 하면 상태가 전환될 경우 콜백은 최신 상태 정보를 제공합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 지원되는 최소 서버 | Windows Server 2012 |
| 대상 플랫폼 | Windows |
| 헤더 | d3dkmthk.h |
| IRQL | <= PASSIVE_LEVEL |