DXGKCB_SETPOWERCOMPONENTACTIVE 콜백 함수(d3dkmddi.h)
디스플레이 미니포트 드라이버는 전원 구성 요소에 액세스하기 위해 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 |