DXGKDDISETPOWERCOMPONENTFSTATE 콜백 함수(d3dkmddi.h)

아티클
02/26/2024

전원 구성 요소를 유휴 상태(F-상태)로 전환하기 위해 Microsoft DirectX 그래픽 커널 하위 시스템에 의해 호출됩니다.

구문

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

매개 변수

DriverContext

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수는 이전에 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

ComponentIndex

DXGKARG_QUERYADAPTERINFO 지정한 전원 구성 요소 인덱스입니다. dxgkDdiQueryAdapterInfo 함수에 대한 호출의 pInputData입니다.

FState

디스플레이 미니포트 드라이버가 DirectX 그래픽 커널 하위 시스템에 보고한 F-상태 값입니다.

반환 값

성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 STATUS_INVALID_PARAMETER 반환합니다.

설명

운영 체제는 디스플레이 미니포트 드라이버가 DXGK_DRIVERCAPS 설정하여 지원을 나타내는 경우에만 DxgkDdiSetPowerComponentFState를 호출합니다. SupportRuntimePowerManagement를 TRUE로 설정합니다.

참고 교착 상태를 방지하려면 이 함수가 반환될 때까지 DxgkCbSetPowerComponentActive 함수를 호출하지 마세요.

디스플레이 미니포트 드라이버가 전원 구성 요소를 F0 상태에서 다른 F-상태로 전환할 때 나중에 구성 요소를 F0 상태로 복원하는 데 필요한 컨텍스트를 저장해야 합니다.

전원 관리 프레임워크는 구성 요소를 F0 상태로 전환하거나 F0 상태에서만 전환합니다.

이 함수는 여러 실행 스레드에서 동시에 호출할 수 있습니다. 그러나 한 번에 하나의 스레드만 이 함수를 호출하여 특정 구성 요소를 제어할 수 있습니다.

운영 체제는 이 함수가 스레딩 및 동기화 0 수준에 정의된 대로 0 수준 동기화 모드를 따르도록 보장합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	데스크톱
머리글	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL