DXGKCB_SETPOWERCOMPONENTACTIVE 콜백 함수(d3dkmddi.h)

아티클
02/26/2024

디스플레이 미니포트 드라이버는 전원 구성 요소에 액세스하기 위해 DXGKCB_SETPOWERCOMPONENTACTIVE 호출합니다. 이 함수가 반환되면 디스플레이 미니포트 드라이버가 구성 요소의 하드웨어 설정을 변경할 수 있습니다.

구문

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

매개 변수

[in] hAdapter

디스플레이 어댑터에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 DxgkDdiStartDevice 함수를 호출하여 DXGKRNL_INTERFACE 구조체의 DeviceHandle 멤버로부터 핸들을 받습니다.

[in] ComponentIndex

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

반환 값

없음

설명

이 함수에 대한 각 호출은 구성 요소 하드웨어가 더 이상 필요하지 않음을 나타내기 위해 DXGKCB_SETPOWERCOMPONENTIDLE 함수에 대한 호출과 페어링되어야 합니다.

이 함수가 호출되면 구성 요소의 활성 참조 수가 1씩 증가합니다. Power Management Framework는 참조 수를 유지하고 참조 수가 0이 될 때만 구성 요소를 더 낮은 F 상태로 만듭니다.

이 함수를 호출하는 동안 디스플레이 미니포트 드라이버는 다른 실행 스레드에서 DxgkDdiSetPowerComponentFState 함수에 대한 호출을 받을 수 있습니다.

DXGKCB_XXX 함수는 Dxgkrnl에 의해 구현됩니다. 이 콜백 함수를 사용하려면 DXGKRNL_INTERFACE 통해 DxgkCbSetPowerComponentActive를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8(WDDM 1.2)
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	데스크톱
머리글	d3dkmddi.h(D3dkmddi.h 포함)
IRQL	PASSIVE_LEVEL