MFCreateSampleCopierMFT 函式 (mfidl.h)
建立範例複製器轉換的實例。
語法
HRESULT MFCreateSampleCopierMFT(
[out] IMFTransform **ppCopierMFT
);
參數
[out] ppCopierMFT
接收 IMFTransform 介面的指標。 呼叫端必須釋放 介面。
傳回值
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
範例複製器是媒體基礎轉換 (MFT) ，可將資料從輸入範例複製到輸出範例，而不需修改資料。 下列資料會從範例複製：
- 所有 範例屬性。
- 時間戳記和持續時間。
- (範例旗標請參閱 IMFSample：：SetSampleFlags) 。
- 媒體緩衝區中的資料。 如果輸入範例包含多個緩衝區，資料就會複製到輸出範例上的單一緩衝區。
- 一個管線物件，例如媒體來源，會配置媒體範例以供輸出使用。
- 另一個管線物件，例如媒體接收，會配置自己的媒體範例以供輸入。 例如，物件可能需要從特殊記憶體集區配置的緩衝區，例如視訊記憶體。
為了讓媒體接收接收來自媒體來源的資料，必須將資料複製到媒體接收所擁有的媒體範例中。 範例複製器可用於此用途。
這類媒體接收的特定範例是 增強式視訊轉譯器 (EVR) 。 EVR 會配置包含 Direct3D 表面緩衝區的範例，因此無法直接從媒體來源接收視訊樣本。 從 Windows 7 開始，拓撲載入器會自動處理此案例，方法是在媒體來源與 EVR 之間插入範例複製器。
需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mfidl.h |
| 程式庫 | Mf.lib |
| Dll | Mf.dll |