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나노초입니다. 전원 관리 프레임워크는 이 정보를 사용하여 요청된 상주를 위반하지 않는 구성 요소에 대한 적절한 유휴 상태를 선택합니다. Residency에서 지정한 예상 상주는 드라이버가 이 함수를 다시 호출하여 업데이트할 때까지 계속 적용됩니다. 설명 부분을 참조하세요.

반환 값

없음

설명

참고

디스플레이 미니포트 드라이버는 구성 요소 유형이 DXGK_POWER_COMPONENT_OTHER 경우에만 이 함수를 호출해야 합니다. DirectX 그래픽 커널 하위 시스템은 다른 구성 요소 형식에 대해 예상되는 상주 값을 설정합니다.

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

이 함수가 호출될 때 전원 구성 요소가 유휴 상태인 경우 Power Management Framework 는 Residency에 지정된 예상 상주 값에 맞게 구성 요소의 F 상태를 변경할 수 있습니다.

드라이버가 Residency 를 PO_FX_UNKNOWN_TIME 값( Wdm.h에 정의됨)으로 설정하는 경우 PEP(전원 엔진 플러그 인)에서 구성 요소를 F0보다 낮은 F 상태로 설정하지 못할 수 있습니다.

요구 사항

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

추가 정보

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice