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

추가 정보

DEVICE_POWER_STATE