IMFPMediaPlayer::SetPosition 메서드(mfplay.h)
재생 위치를 설정합니다.
구문
HRESULT SetPosition(
[in] REFGUID guidPositionType,
[in] const PROPVARIANT *pvPositionValue
);
매개 변수
[in] guidPositionType
재생 위치의 시간 단위입니다. 다음 값이 정의됩니다.
값 | 의미 |
---|---|
|
100나노초 단위.
pvPositionValue 값은 LARGE_INTEGER.
|
[in] pvPositionValue
새 재생 위치입니다. 이 매개 변수의 의미와 데이터 형식은 guidPositionType 매개 변수로 표시됩니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | 설명 |
---|---|
|
메서드가 성공했습니다. |
|
인수가 잘못되었습니다. |
|
pvPositionValue 값이 잘못되었습니다. |
|
미디어 항목이 큐에 대기되지 않았습니다. |
|
개체의 Shutdown 메서드가 호출되었습니다. |
설명
재생이 중지되는 동안 이 메서드를 호출하면 재생이 다시 시작된 후 새 위치가 적용됩니다.
이 메서드는 비동기적으로 완료됩니다. 작업이 완료되면 애플리케이션의 IMFPMediaPlayerCallback::OnMediaPlayerEvent 콜백 메서드가 호출됩니다. 이벤트 유형이 MFP_EVENT_TYPE_POSITION_SET.
SetPosition이 호출되기 전에 재생이 시작된 경우 재생이 새 위치에서 다시 시작됩니다. 재생이 일시 중지된 경우 비디오가 새로 고쳐지고 현재 프레임이 새 위치에 표시됩니다.
guidPositionType이 MFP_POSITIONTYPE_100NS 동일한 SetPosition을 두 차례 연속으로 호출하고 첫 번째 호출이 완료되기 전에 두 번째 호출이 수행되면 두 번째 호출이 첫 번째 호출을 대체합니다. 대체된 호출에 대한 상태 코드는 해당 호출에 대한 이벤트 데이터에서 S_FALSE 설정됩니다. 이 동작은 각 호출이 미디어 원본이 상대적으로 긴 검색 작업을 수행하도록 강제할 수 있으므로 SetPosition에 대한 반복 호출에서 과도한 대기 시간을 방지합니다.
요구 사항
지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | mfplay.h |
참고 항목
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기