다음을 통해 공유


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

추가 정보

IDCompositionAnimation