IMFCaptureSource：：AddEffect 方法 (mfcaptureengine.h)
將效果新增至擷取數據流。
語法
HRESULT AddEffect(
[in] DWORD dwSourceStreamIndex,
[in] IUnknown *pUnknown
);
參數
[in] dwSourceStreamIndex
擷取數據流。 此值可以是下列任一項。
| 值 | 意義 |
|---|---|
|
數據流以零起始的索引。 若要取得數據流數目，請呼叫 IMFCaptureSource：：GetDeviceStreamCount。 |
|
第一個影像數據流。 |
|
第一個視訊串流。 |
|
第一個音訊數據流。 |
[in] pUnknown
下列其中一項的指標：
- 媒體基礎轉換 (MFT) ，可公開 IMFTransform 介面。
- 公開 IMFActivate 介面的 MFT 啟用物件。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
找不到相容的媒體類型。 |
|
dwSourceStreamIndex 參數無效。 |
備註
效果必須實作為 媒體基礎轉換 (MFT) 。 pUnknown 參數可以指向 MFT 的實例，或指向 MFT 的啟用物件。 如需詳細資訊，請參閱 啟用物件。
效果會在數據到達擷取接收之前套用至數據流。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mfcaptureengine.h |