DXGKCB_COMPLETEFSTATETRANSITION 콜백 함수(d3dkmddi.h)

DXGKCB_COMPLETEFSTATETRANSITION 전원 구성 요소가 F 상태 전환을 완료했음을 포트 드라이버에 알 수 있습니다.

구문

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

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

매개 변수

[in] hAdapter

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

[in] ComponentIndex

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

반환 값

없음

설명

구성 요소를 등록하는 동안 디스플레이 미니포트 드라이버는 DXGK_POWER_COMPONENT_FLAGS 설정하여 DXGKCB_COMPLETEFSTATETRANSITION 함수를 호출해야 하는 모든 전원 구성 요소를 표시해야 합니다. DriverCompletesFStateTransition 멤버를 1로 설정합니다. 이 멤버가 설정되면 드라이버는 이 함수를 동기적으로 또는 비동기적으로 호출해야 합니다. 반대로 이 멤버가 설정되지 않은 경우 드라이버는 이 함수를 호출하면 안 됩니다.

참고

DXGK_POWER_COMPONENT_FLAGS 경우. DriverCompletesFStateTransition이 설정되었지만 드라이버가 이 함수를 호출하지 않고 교착 상태가 발생할 수 있습니다.

Windows 전원 관리 프레임워크는 이 함수가 호출될 때까지 구성 요소에 대한 새 전환 요청이 전송되지 않음을 보장합니다.

일반적으로 포트 드라이버는 이 함수가 반환되면 F-상태 전환이 완료되는 것으로 예상합니다. 디스플레이 미니포트 드라이버가 DISPATCH_LEVEL 전환을 완료할 수 없거나 다른 전원 구성 요소를 활성화해야 하는 경우와 같이 디스플레이 미니포트 드라이버가 동기적으로 전환을 완료할 수 없는 시나리오가 있을 수 있습니다. 이 함수는 디스플레이 미니포트 드라이버가 F-상태 전환을 비동기적으로 완료하는 데 도움이 됩니다.

DXGKCB_XXX 함수는 Dxgkrnl에 의해 구현됩니다. 이 콜백 함수를 사용하려면 DXGKARGCB_ALLOCATEPAGESFORMDL 멤버를 설정한 다음 DXGKRNL_INTERFACE 통해 DxgkCbCompleteFStateTransition을 호출합니다.

요구 사항

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

추가 정보

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE