IMFSeekInfo::GetNearestKeyFrames 메서드(mfidl.h)

특정 검색 위치의 경우 가장 가까운 두 개의 키 프레임을 가져옵니다.

구문

HRESULT GetNearestKeyFrames(
  [in]  const GUID        *pguidTimeFormat,
  [in]  const PROPVARIANT *pvarStartPosition,
  [out] PROPVARIANT       *pvarPreviousKeyFrame,
  [out] PROPVARIANT       *pvarNextKeyFrame
);

매개 변수

[in] pguidTimeFormat

시간 형식을 지정하는 GUID에 대한 포인터입니다. 시간 형식은 이 메서드의 다른 매개 변수에 대한 단위를 정의합니다. 값이 GUID_NULL 시간 형식은 100나노초 단위입니다. 일부 미디어 원본은 추가 시간 형식 GUID를 지원할 수 있습니다.

[in] pvarStartPosition

검색 위치입니다. 이 매개 변수의 단위는 pguidTimeFormat으로 지정됩니다.

[out] pvarPreviousKeyFrame

pvarStartPosition보다 일찍 표시되는 가장 가까운 키 프레임의 위치를 받습니다. 이 매개 변수의 단위는 pguidTimeFormat으로 지정됩니다.

[out] pvarNextKeyFrame

pvarStartPosition보다 늦게 표시되는 가장 가까운 키 프레임의 위치를 받습니다. 이 매개 변수의 단위는 pguidTimeFormat으로 지정됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_UNSUPPORTED_TIME_FORMAT	pguidTimeFormat에 지정된 시간 형식은 지원되지 않습니다.

설명

애플리케이션이 키가 아닌 프레임을 찾는 경우 디코더는 이전 키 프레임에서 디코딩을 시작해야 합니다. 요청된 프레임에 도달하기 전에 여러 프레임이 디코딩될 수 있으므로 대기 시간이 증가할 수 있습니다. 대기 시간을 줄이기 위해 애플리케이션은 이 메서드를 호출하여 원하는 시간에 가장 가까운 두 개의 키 프레임을 찾은 다음 해당 키 프레임 중 하나를 검색할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfidl.h

참고 항목

IMFSeekInfo