IAMExtTransport::SetEditPropertySet 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼,以使用新的 API。]
方法 SetEditPropertySet
會註冊描述一組編輯屬性的編輯屬性集。
這個方法尚未實作。
語法
HRESULT SetEditPropertySet(
[in, out] long *pEditID,
[in] long State
);
參數
[in, out] pEditID
長整數的指標,指定或接收編輯屬性集的標識碼。
[in] State
指定編輯屬性集的狀態。
值 | Description |
---|---|
ED_ACTIVE | 啟動編輯屬性集。 |
ED_DELETE | 刪除編輯屬性集。 |
ED_INACTIVE | 停用編輯屬性集。 |
ED_REGISTER | 註冊編輯屬性集。 |
如果值 ED_REGISTER,pEditID 參數會收到編輯屬性集的標識碼。 針對其他旗標,請使用 pEditID 參數來指定識別符。
傳回值
當此方法成功時,它會傳回S_OK。 否則會傳回 HRESULT 錯誤碼。
備註
編輯事件是定義錄製序列的一組參數。 例如,參數可以指定編輯模式、點和外點,或搜尋位置。 每個編輯事件都包含一或多個參數,稱為 編輯屬性。 屬性的集合稱為 編輯屬性集。 每個編輯屬性集都是由裝置篩選指派的 長 整數來識別。
若要建立和執行編輯事件,應用程式必須執行下列動作:
- 註冊編輯屬性集。
SetEditPropertySet
使用 State 參數中的值ED_REGISTER呼叫 方法。 當方法傳回時, pEditID 參數會包含編輯屬性集的標識碼。 使用此數位來識別後續方法呼叫中設定的編輯屬性。 - 使用 IAMExtTransport::SetEditProperty 方法指定編輯屬性。
- 使用
SetEditPropertySet
值呼叫 ED_ACTIVE 來啟動編輯事件。 - 使用值ED_EDIT_SEEK呼叫
SetEditProperty
來提示傳輸。 - 執行篩選圖形。
C++ |
---|
註冊編輯屬性集標識碼。 (導致配置記憶體。) 長EditId;SetEditPropertySet (&EditId,ED_REGISTER) ; |
DV 實作
MSDV 不支援此方法。 它會傳回E_NOTIMPL。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | strmif.h (包含 Dshow.h) |
程式庫 | Strmiids.lib |