다음을 통해 공유


CPullPin.Receive 메서드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 Receive 개체가 출력 핀에서 미디어 샘플을 받을 때 호출됩니다. 파생 클래스는 이 메서드를 구현해야 합니다.

구문

virtual HRESULT Receive(
   IMediaSample *pSample
) = 0;

매개 변수

pSample

미디어 샘플의 IMediaSample 인터페이스에 대한 포인터입니다.

반환 값

HRESULT 값을 반환합니다. S_OK 이외의 값을 반환하면 데이터 풀링 스레드가 중지됩니다.

설명

이 메서드는 출력 핀에서 새 샘플이 도착할 때마다 호출됩니다. IMemInputPin::Receive 메서드와 동일한 방식으로 이 메서드를 작성합니다.

샘플의 타임스탬프는 CPullPin::Seek 메서드에 지정된 원래 시작 위치를 기준으로 바이트 오프셋을 지정합니다.

시작 위치는 가장 가까운 맞춤 경계로 반올림되고 중지 위치는 가장 가까운 맞춤 경계로 반올림됩니다. 또한 중지 위치가 총 기간을 초과하면 해당 기간이 대신 사용됩니다.

모든 타임스탬프는 상수 단위로 정의된 10,000,000을 곱한 바이트 오프셋으로 제공됩니다. 따라서 개념적으로 1초는 1 바이트입니다. 실제 바이트 오프셋을 찾으려면 IMediaSample::GetTime 을 호출하고 결과를 UNITS로 나눕니다.

요구 사항

요구 사항
헤더
Pullpin.h
라이브러리
Strmbase.lib(소매 빌드);
Strmbasd.lib(디버그 빌드)

추가 정보

CPullPin 클래스