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 |