MFCreateLegacyMediaBufferOnMFMediaBuffer 함수(mfapi.h)

아티클
08/24/2023

Media Foundation 미디어 버퍼를 DDO(DirectX Media Objects)와 호환되는 버퍼로 변환합니다.

구문

HRESULT MFCreateLegacyMediaBufferOnMFMediaBuffer(
  IMFSample      *pSample,
  IMFMediaBuffer *pMFMediaBuffer,
  DWORD          cbOffset,
  IMediaBuffer   **ppMediaBuffer
);

매개 변수

pSample

Media Foundation 버퍼를 포함하는 샘플의 IMFSample 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

pMFMediaBuffer

Media Foundation 버퍼의 IMFMediaBuffer 인터페이스에 대한 포인터입니다.

cbOffset

Media Foundation 버퍼의 시작부터 오프셋(바이트)입니다. 이 오프셋은 DMO 버퍼가 시작되는 위치를 정의합니다. 이 매개 변수가 0이면 DMO 버퍼가 Media Foundation 버퍼의 시작 부분에서 시작됩니다.

ppMediaBuffer

IMediaBuffer 인터페이스에 대한 포인터를 받습니다. 이 인터페이스는 DirectShow SDK 설명서에 설명되어 있습니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드	Description
S_OK	함수가 성공했습니다.
E_INVALIDARG	인수가 잘못되었습니다. pIMFMediaBuffer 매개 변수는 NULL이 아니어야 합니다.

설명

이 함수에서 만든 DMO 버퍼는 IMFSample 인터페이스도 노출합니다. pIMFSample이 NULL이면 모든 IMFSample 메서드는 MF_E_NOT_INITIALIZED 반환합니다. 그렇지 않으면 pIMFSample 포인터를 통해 를 호출합니다.

pIMFMediaBuffer로 지정된 Media Foundation 버퍼가 IMF2DBuffer 인터페이스를 노출하는 경우 DMO 버퍼는 IMF2DBuffer도 노출합니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mfapi.h
라이브러리	Mfplat.lib
DLL	Mfplat.dll