共用方式為


MFCreateMediaBufferWrapper 函式 (mfapi.h)

建立包裝現有媒體緩衝區的媒體緩衝區。 新的媒體緩衝區會指向與原始媒體緩衝區相同的記憶體,或指向記憶體開頭的位移。

語法

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

參數

[in] pBuffer

原始媒體緩衝區之 IMFMediaBuffer 介面的指標。

[in] cbOffset

新緩衝區的開頭,作為原始緩衝區開頭的位元組位移。

[in] dwLength

新緩衝區的大小。 cbOffset + dwLength 的值必須小於或等於原始緩衝區的有效數據大小。 (IMFMediaBuffer::GetCurrentLength 方法傳回有效數據的大小。)

[out] ppBuffer

接收 IMFMediaBuffer 介面的指標。 呼叫端必須釋放 介面。

傳回值

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

傳回碼 描述
S_OK
此函數已成功。
E_INVALIDARG
要求的位移或要求的長度無效。

備註

包裝函式緩衝區的大小上限限制為原始緩衝區中有效數據的大小。 這可能小於原始緩衝區的配置大小。 若要設定有效數據的大小,請呼叫 IMFMediaBuffer::SetCurrentLength

如果已安裝 Windows Media Format 11 SDK 可轉散發元件,此函式可在下列平臺上使用:

  • Windows XP with Service Pack 2 (SP2) 和更新版本。
  • 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center 版本 2005) 和 KB925766 (2006 年 10 月更新匯總) 。

規格需求

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

另請參閱

媒體緩衝區

媒體基礎函式