IDCompositionAnimation::End 메서드(dcompanimation.h)

애니메이션 함수의 끝을 표시하는 끝 세그먼트를 추가합니다.

구문

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

매개 변수

[in] endOffset

형식: double

애니메이션 함수의 시작부터 함수가 종료되는 지점까지의 오프셋(초)입니다.

[in] endValue

형식: float

애니메이션의 최종 값입니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.

설명

지정된 오프셋에 도달하면 이 애니메이션의 영향을 받는 속성 또는 속성이 지정된 최종 값으로 설정된 다음 애니메이션이 중지됩니다. 끝 세그먼트가 추가되지 않으면 애니메이션 함수의 최종 세그먼트가 무기한 실행됩니다. 이 메서드를 호출하는 것은 애니메이션 함수의 마지막 세그먼트를 입방형 다항식으로 만드는 것과 의미상 동일합니다. 여기서 입방형, 4차원 및 선형 계수는 모두 0이고 상수 계수는 원하는 최종 값입니다.

애니메이션 세그먼트를 증가하는 순서로 추가해야 하므로 endOffset 매개 변수가 이전 세그먼트의 beginOffset 매개 변수보다 작거나 같으면 이 메서드가 실패합니다. 애니메이션 함수에 추가할 첫 번째 세그먼트인 경우에도 이 메서드가 실패합니다.

이 메서드가 호출되면 IDCompositionAnimation::Reset 메서드를 제외한 이 애니메이션 개체의 모든 메서드가 실패합니다.

요구 사항

추가 정보

IDCompositionAnimation