MFCreateLegacyMediaBufferOnMFMediaBuffer 函式 (mfapi.h)

發行項
03/15/2023

將 Media Foundation 媒體緩衝區轉換成與 DirectX 媒體物件相容的緩衝區， (DMO) 。

語法

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

參數

pSample

包含媒體基礎緩衝區之範例的 IMFSample 介面指標。此參數可以是 Null。

pMFMediaBuffer

媒體基礎緩衝區之 IMFMediaBuffer 介面的指標。

cbOffset

從 Media Foundation 緩衝區的開頭位移以位元組為單位。此位移會定義 DMO 緩衝區開始的位置。如果此參數為零，DMO 緩衝區會從 Media Foundation 緩衝區的開頭開始。

ppMediaBuffer

接收 IMediaBuffer 介面的指標。此介面記載于 DirectShow SDK 檔中。呼叫端必須釋放介面。

傳回值

函式會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此函數已成功。
E_INVALIDARG	無效引數。 pIMFMediaBuffer參數不得為Null。

備註

此函式所建立的 DMO 緩衝區也會公開 IMFSample 介面。如果 pIMFSample 為 Null，則所有 IMFSample 方法都會傳回MF_E_NOT_INITIALIZED。否則，他們會呼叫 pIMFSample 指標。

如果 pIMFMediaBuffer 指定的媒體基礎緩衝區公開了 IMF2DBuffer 介面，DMO 緩衝區也會公開 IMF2DBuffer。

需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	mfapi.h
程式庫	Mfplat.lib
Dll	Mfplat.dll