MFStartup 함수(mfapi.h)

Microsoft Media Foundation을 초기화합니다.

구문

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Version

버전 번호. mfapi.h에 정의된 값 MF_VERSION 사용합니다.

dwFlags

이 매개 변수는 C++를 사용할 때 선택 사항이지만 C에서 필요합니다. 값은 다음 플래그 중 하나여야 합니다.

값	의미
MFSTARTUP_NOSOCKET	소켓 라이브러리를 초기화하지 마세요.
MFSTARTUP_LITE	MFSTARTUP_NOSOCKET 동일합니다.
MFSTARTUP_FULL	전체 Media Foundation 플랫폼을 초기화합니다. dwFlags를 지정하지 않은 경우 기본값입니다.

함수는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
MF_E_BAD_STARTUP_VERSION	Version 매개 변수에는 실행 중인 버전보다 최신 버전의 Media Foundation이 필요합니다.
MF_E_DISABLED_IN_SAFEMODE	시스템이 "안전 모드"(장애 조치(fail-safe) 부팅)에서 시작되었기 때문에 Media Foundation 플랫폼이 비활성화되었습니다.
E_NOTIMPL	Media Foundation은 시스템에서 구현되지 않습니다. 미디어 구성 요소가 없는 경우 이 오류가 발생할 수 있습니다(자세한 내용은 KB2703761 참조).

애플리케이션은 Media Foundation을 사용하기 전에 이 함수를 호출해야 합니다. 애플리케이션이 종료되기 전에 MFStartup에 대한 모든 이전 호출에 대해 MFShutdown을 한 번 호출합니다.

프로세스 초기화 중에 정적 생성자가 아닌 앱 초기화 중에 MFStartup을 호출해야 합니다.

작업 큐 스레드에서 MFStartup 또는 MFShutdown 을 호출하지 마세요. 작업 큐에 대한 자세한 내용은 작업 큐를 참조하세요.

이 함수는 Windows Media Format 11 SDK 재배포 가능 구성 요소가 설치된 경우 다음 플랫폼에서 사용할 수 있습니다.

Windows XP SP2(서비스 팩 2) 이상
KB900325(Windows XP Media Center Edition 2005) 및 KB925766(Windows XP Media Center Edition용 2006년 10월 업데이트 롤업)가 설치된 Windows XP Media Center Edition 2005.

    hr = MFStartup(MF_VERSION);