MFCreateSinkWriterFromURL 함수(mfreadwrite.h)

  • 아티클

URL 또는 바이트 스트림에서 싱크 기록기를 만듭니다.

구문

HRESULT MFCreateSinkWriterFromURL(
  [in]  LPCWSTR       pwszOutputURL,
  [in]  IMFByteStream *pByteStream,
  [in]  IMFAttributes *pAttributes,
  [out] IMFSinkWriter **ppSinkWriter
);

매개 변수

[in] pwszOutputURL

출력 파일의 URL을 포함하는 null로 끝나는 문자열입니다. 이 매개 변수는 NULL일 수 있습니다.

[in] pByteStream

바이트 스트림의 IMFByteStream 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

이 매개 변수가 유효한 포인터인 경우 싱크 작성기는 제공된 바이트 스트림에 씁니다. (바이트 스트림은 쓰기 가능해야 합니다.) 그렇지 않으면 pByteStream 이 NULL이면 싱크 작성기는 pwszOutputURL이라는 새 파일을 만듭니다.

[in] pAttributes

IMFAttributes 인터페이스에 대한 포인터입니다. 이 매개 변수를 사용하여 싱크 기록기를 구성할 수 있습니다. 자세한 내용은 싱크 작성기 특성을 참조하세요. 이 매개 변수는 NULL일 수 있습니다.

[out] ppSinkWriter

IMFSinkWriter 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드 Description
S_OK
 성공.
MF_E_NOT_FOUND
 지정된 URL을 찾을 수 없습니다.

설명

이 함수를 호출하기 전에 CoInitialize(Ex) 및 MFStartup을 호출합니다.

이 함수의 처음 세 매개 변수는 NULL일 수 있습니다. 그러나 특정 조합만 유효합니다.

Description pwszOutputURL pByteStream pAttributes
URL 없이 바이트 스트림을 지정합니다. NULL NULL이 아닌 경우 필수( NULL이 아니어야 합니다).
바이트 스트림 없이 URL을 지정합니다. NULL이 아님 NULL 선택 사항( NULL일 수 있음).
URL과 바이트 스트림을 모두 지정합니다. NULL이 아닌 경우 NULL이 아닌 경우 선택 사항( NULL일 수 있음).
 

pAttributes 매개 변수는 첫 번째 경우 필수이고 다른 경우에는 선택 사항입니다.

  • 사례 1: URL 없이 바이트 스트림을 지정합니다. pAttributes 매개 변수는 MF_TRANSCODE_CONTAINERTYPE 특성이 포함된 특성 저장소를 가리킵니다. 싱크 작성기는 MF_TRANSCODE_CONTAINERTYPE 특성을 사용하여 ASF 또는 MP4와 같이 쓸 파일 컨테이너의 형식을 결정합니다.
  • 사례 2: 바이트 스트림 없이 URL을 지정합니다. 싱크 작성기는 pwszOutputURL이라는 새 파일을 만듭니다. pAttributes가 MF_TRANSCODE_CONTAINERTYPE 특성을 사용하여 특성 저장소를 지정하는 경우 싱크 작성기는 해당 특성을 사용하여 파일 컨테이너의 형식을 확인합니다. 그렇지 않으면 MF_TRANSCODE_CONTAINERTYPE 특성이 없거나 pAttributes 가 NULL인 경우 싱크 작성기는 파일 이름 확장명을 사용하여 컨테이너 형식을 선택합니다. 예를 들어 ASF 파일의 ".asf"입니다.
  • 사례 3: URL과 바이트 스트림을 모두 지정합니다. 싱크 작성기는 바이트 스트림에 씁니다. pwszOutputURL에 제공된 URL은 정보 전용입니다. 싱크 작성기가 새 파일을 만들지 않습니다. pAttributes가 MF_TRANSCODE_CONTAINERTYPE 특성을 사용하여 특성 저장소를 지정하는 경우 싱크 작성기는 해당 특성을 사용하여 파일 컨테이너의 형식을 확인합니다. 그렇지 않으면 싱크 작성기에서 파일 이름 확장명을 사용하여 컨테이너 형식을 선택합니다. 이 경우 MF_TRANSCODE_CONTAINERTYPE 특성은 URL 파일 이름 확장명을 재정의합니다.
이 함수는 Windows Vista용 플랫폼 업데이트 보충이 설치된 경우 Windows Vista에서 사용할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista용 Windows 7, Windows Vista 및 플랫폼 업데이트 보충 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 mfreadwrite.h
라이브러리 Mfreadwrite.lib
DLL Mfreadwrite.dll

추가 정보

미디어 파운데이션 함수