IDCompositionAnimation::SetAbsoluteBeginTime 메서드(dcompanimation.h)
애니메이션 함수가 시작되는 절대 시간을 설정합니다.
구문
HRESULT SetAbsoluteBeginTime(
[in] LARGE_INTEGER beginTime
);
매개 변수
[in] beginTime
형식: LARGE_INTEGER
이 애니메이션의 시작 시간입니다.
반환 값
형식: HRESULT
함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.
설명
기본적으로 애니메이션 함수는 애니메이션의 첫 번째 프레임이 적용될 때 시작됩니다. 예를 들어 애플리케이션이 오프셋 0에 단일 기본 형식을 사용하여 간단한 애니메이션 함수를 만들고 애니메이션을 일부 속성과 연결한 다음 커밋을 포함하는 첫 번째 프레임인 IDCompositionDevice::Commit 메서드를 호출하면 첫 번째 기본 형식에 대한 오프셋 0에서 애니메이션이 샘플됩니다.
즉, 모든 애니메이션의 실제 기본 시작 시간은 애플리케이션이 애니메이션을 만들고 Commit을 호출하는 시점부터 컴퍼지션 엔진이 커밋된 변경 내용을 선택하는 데 걸리는 시간 사이의 시간에 따라 달라집니다. 애플리케이션은 SetAbsoluteBeginTime 메서드를 사용하여 애니메이션의 시작 시간을 더 세밀하게 제어할 수 있습니다.
이 메서드는 애니메이션이 적용되는 시기를 제어하지 않습니다. 시작 후 애니메이션이 샘플링되는 방식에만 영향을 줍니다. 애플리케이션이 다음 프레임의 정확한 시간을 절대 시작 시간으로 지정하는 경우 결과는 이 메서드를 전혀 호출하지 않는 것과 동일합니다. 지정된 시작 시간이 다음 프레임의 시간과 다른 경우 결과는 다음 중 하나입니다.
- 지정된 시간이 다음 프레임 시간보다 늦으면 애니메이션 시작은 지정된 시작 시간까지 지연됩니다.
- 지정된 시간이 다음 프레임 시간보다 빠르면 애니메이션의 시작이 삭제되고 샘플링이 애니메이션 함수로 시작됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | dcompanimation.h |
| 라이브러리 | Dcomp.lib |
| DLL | Dcomp.dll |