DXGKCB_SETPOWERCOMPONENTRESIDENCY 콜백 함수(d3dkmddi.h)
커널 모드 디스플레이 미니포트 드라이버는 DXGKCB_SETPOWERCOMPONENTRESIDENCY 호출하여 DXGK_POWER_COMPONENT_OTHER형식의 전원 구성 요소에 대한 예상 상주를 설정합니다.
통사론
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
매개 변수
[in] hAdapter
디스플레이 어댑터에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 DxgkDdiStartDevice 함수에 대한 호출에서 DXGKRNL_INTERFACE 구조체의 DeviceHandle 멤버로부터 핸들을 받습니다.
[in] ComponentIndex
DXGKARG_QUERYADAPTERINFO지정된 전원 구성 요소 인덱스입니다. DxgkDdiQueryAdapterInfo 함수에 대한 호출에서 pInputData.
[in] Residency
디스플레이 미니포트 드라이버에서 유휴 상태로 전환된 후 전원 구성 요소가 유휴 상태로 유지될 것으로 예상하는 최대 시간(최대 시간 100나노초)입니다. Power Management Framework 이 정보를 사용하여 요청된 상주를 위반하지 않는 구성 요소에 적절한 유휴 상태를 선택합니다. Residency 지정된 예상 보존은 드라이버가 이 함수를 다시 호출하여 업데이트할 때까지 계속 적용됩니다. 비고를 참조하세요.
반환 값
없음
발언
메모
디스플레이 미니포트 드라이버는 구성 요소 형식이 DXGK_POWER_COMPONENT_OTHER경우에만 이 함수를 호출해야 합니다. DirectX 그래픽 커널 하위 시스템은 다른 구성 요소 형식에 대해 예상되는 상주 값을 설정합니다.
DXGKCB_XXX 함수는 Dxgkrnl의해 구현됩니다. 이 콜백 함수를 사용하려면 DXGKRNL_INTERFACE통해 DxgkCbSetPowerComponentResidency 호출합니다.
이 함수가 호출될 때 전원 구성 요소가 유휴 상태인 경우 Power Management FrameworkResidency지정된 예상 상주 값에 맞게 구성 요소의 F 상태를 변경할 수 있습니다.
드라이버가 상주PO_FX_UNKNOWN_TIME 값(Wdm.h정의됨)으로 설정하면 PEP(전원 엔진 플러그 인)에서 구성 요소를 F0보다 낮은 F 상태로 설정하지 못할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8(WDDM 1.2) |
| 지원되는 최소 서버 | Windows Server 2012 |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | d3dkmddi.h(D3dkmddi.h 포함) |
| IRQL | <= DISPATCH_LEVEL |