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 |
|---|---|
|
성공. |
|
지정된 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 7, Windows Vista 및 플랫폼 업데이트 보충 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | mfreadwrite.h |
| 라이브러리 | Mfreadwrite.lib |
| DLL | Mfreadwrite.dll |