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 |