XDisplayAcquireTimeoutDeferral
화면 시간 초과 지연을 획득합니다.
매개 변수
handle _Out_
형식: XDisplayTimeoutDeferralHandle*
화면 시간 초과 지연 핸들에 대한 포인터입니다.
반환 값
형식: HRESULT
성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요.
이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은
시간에 민감한 스레드를 참조하세요.
화면 시간 초과 지연은 사용자의 조작이 없는 동안 화면이 어두워지거나 잠기거나 전원이 꺼지지 않도록 합니다. 일정 시간 동안 사용자의 조작이 없으면 화면 시간 초과가 발생합니다. 화면 시간 초과에 대응하여 장치는 디스플레이를 어둡게 하거나, 잠금 화면을 활성화하거나, 디스플레이의 전원을 끌 수 있습니다. 화면 시간 초과가 발생하기 전에 필요한 유휴 시간은 장치의 사용자 설정에 따라 다릅니다. 게임이 사용자 상호 작용을 필요로 하지 않는 활동(예: 게임 리소스 로드 또는 긴 컷신 표시)을 수행하는 경우 화면 시간 초과는 불편할 수 있습니다. 화면 시간 초과 지연을 획득하여 화면 시간 초과를 방지할 수 있습니다.
화면 시간 초과 지연을 획득하려면 먼저 XDisplayAcquireTimeoutDeferral을 호출하여 화면 시간 초과 지연에 대한 핸들을 획득한 다음, 더 이상 필요하지 않을 때 XDisplayCloseTimeoutDeferralHandle을 호출하여 핸들을 닫습니다. 게임이 포커스를 잃으면 화면 시간 초과 지연은 무시되며, 게임이 종료되면 해제됩니다.
이 함수를 사용하여 화면 시간 초과 지연 핸들을 획득하는 경우, XDisplayCloseTimeoutDeferralHandle을 호출하여 해당 핸들을 닫아야 합니다. 여러 개의 화면 시간 초과 지연 핸들을 획득할 수 있으며, 모든 화면 시간 초과 지연 핸들이 닫힌 후에만 게임에 대한 화면 시간 초과가 활성화됩니다.
타이틀이 활발히 디버깅되는 동안에는 화면 디밍이 발생하지 않습니다.
다음 예제는 XDisplayAcquireTimeoutDeferral을 호출하여 새 화면 시간 초과 지연 핸들을 획득한 후 긴 도입 컷신을 재생합니다. 새 핸들이 성공적으로 획득되면, 사용자의 조작이 없더라도 긴 도입 컷신이 화면 시간 초과 없이 재생될 수 있습니다. 컷신 재생이 끝난 후 이 예제는 XDisplayCloseTimeoutDeferralHandle을 호출하여 핸들을 닫습니다. 모든 화면 시간 초과 지연 핸들이 닫힌 후에는 사용자의 조작이 없을 때 다시 화면 시간 초과가 발생할 수 있습니다.
요구 사항
헤더: XDisplay.h
라이브러리: xgameruntime.lib
지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔
개념 문서
함께 보기
XDisplayCloseTimeoutDeferralHandle
XDisplay