IMFSampleGrabberSinkCallback2::OnProcessSampleEx 메서드(mfidl.h)

sample-grabber 싱크가 새 미디어 샘플을 수신할 때 호출됩니다.

구문

HRESULT OnProcessSampleEx(
  [in] REFGUID       guidMajorMediaType,
  [in] DWORD         dwSampleFlags,
  [in] LONGLONG      llSampleTime,
  [in] LONGLONG      llSampleDuration,
  [in] const BYTE    *pSampleBuffer,
  [in] DWORD         dwSampleSize,
  [in] IMFAttributes *pAttributes
);

매개 변수

[in] guidMajorMediaType

데이터의 형식을 지정하는 주 형식 GUID입니다. 가능한 값 목록은 주 미디어 형식을 참조하세요.

[in] dwSampleFlags

샘플 플래그. sample-grabber 싱크는 미디어 샘플의 IMFSample::GetSampleFlags 메서드를 호출하여 이 매개 변수의 값을 가져옵니다.

[in] llSampleTime

이 샘플의 프레젠테이션 시간(100나노초 단위)입니다. 샘플에 프레젠테이션 시간이 없으면 이 매개 변수의 값이 _I64_MAX

[in] llSampleDuration

샘플 기간(100나노초 단위)입니다.

샘플에 기간이 없으면 이 매개 변수의 값이 _I64_MAX.

[in] pSampleBuffer

샘플 데이터를 포함하는 버퍼에 대한 포인터입니다.

[in] dwSampleSize

pSampleBuffer 버퍼의 크기(바이트)입니다.

[in] pAttributes

IMFAttributes 인터페이스에 대한 포인터입니다. 이 인터페이스를 사용하여 이 샘플의 특성을 가져옵니다(있는 경우). 샘플 특성 목록은 샘플 특성을 참조하세요.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

재생 토폴로지에서 샘플 그래버 싱크를 사용하는 경우 이 메서드는 신속하게 반환되거나 재생을 방해할 수 있습니다. 스레드를 차단하거나, 이벤트를 기다리거나, 이 메서드 내에서 다른 긴 작업을 수행하지 마세요.

요구 사항

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

참고 항목

IMFSampleGrabberSinkCallback2