IMFCaptureSink::AddStream 메서드(mfcaptureengine.h)

  • 아티클

캡처 원본의 스트림을 이 캡처 싱크에 연결합니다.

구문

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

매개 변수

[in] dwSourceStreamIndex

연결할 원본 스트림입니다. 값은 다음 중 한 개일 수 있습니다.

값 의미
0~0xFFFFFFFB
 스트림의 인덱스(0부터 시작)입니다. 스트림 수를 얻으려면 IMFCaptureSource::GetDeviceStreamCount를 호출합니다.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 첫 번째 이미지 스트림입니다.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 첫 번째 비디오 스트림입니다.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 첫 번째 오디오 스트림입니다.

[in] pMediaType

출력 스트림의 원하는 형식을 지정하는 IMFMediaType 포인터입니다. 형식의 세부 정보는 캡처 싱크에 따라 달라집니다.

  • 사진 싱크: WIC( Windows 이미징 구성 요소 )와 호환되는 스틸 이미지 형식입니다.
  • 미리 보기 싱크: 압축되지 않은 오디오 또는 비디오 형식입니다.
  • 레코드 싱크: 출력 파일에 쓸 오디오 또는 비디오 형식입니다.

[in] pAttributes

IMFAttributes 인터페이스에 대한 포인터입니다. 압축 스트림의 경우 이 매개 변수를 사용하여 인코더를 구성할 수 있습니다. 이 매개 변수는 NULL일 수도 있습니다.

미리 보기 싱크의 경우 이 매개 변수를 NULL로 설정합니다.

[out] pdwSinkStreamIndex

캡처 싱크에서 새 스트림의 인덱스를 받습니다. 이 인덱스가 반드시 dwSourceStreamIndex 값과 일치하지는 않습니다.

반환 값

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

반환 코드 Description
S_OK
 성공.
MF_E_INVALIDMEDIATYPE
 pMediaType에 지정된 형식이 이 캡처 싱크에 유효하지 않습니다.
MF_E_INVALIDSTREAMNUMBER
 dwSourceStreamIndex 매개 변수가 잘못되었거나 지정된 원본 스트림이 이미 이 싱크에 연결되었습니다.

요구 사항

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

추가 정보

IMFCaptureSink