共用方式為


IAMExtTransport::SetEditPropertySet 方法 (strmif.h)

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 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) ;

設定編輯模式。 SetEditProperty (EditId, ED_EDIT_MODE, ED_EDIT_MODE_INSERT) ;設定事件的相關詳細數據。 SetEditProperty (EditId,ED_EDIT_TRACK,ED_VIDEO |ED_AUDIO_ALL) ;SetEditProperty (EditId, ED_REHEARSE_MODE, ED_EDIT_PERFORM) ;

設定來源和記錄時間。 SetEditProperty (EditId, ED_EDIT_SRC_INPOINT, 200) SetEditProperty (EditId, ED_EDIT_SRC_OUTPOINT, 500) SetEditProperty (EditId, ED_EDIT_REC_INPOINT, 100) SetEditProperty (EditId, ED_EDIT_REC_OUTPOINT, 400)

啟動編輯事件。 SetEditPropertySet (&EditId,ED_ACTIVE) ;提示機器。 SetEditProperty (EditId, ED_EDIT_SEEK, OATRUE) ;

// Run the graph. (Not shown.)

DV 實作

MSDV 不支援此方法。 它會傳回E_NOTIMPL。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IAMExtTransport 介面

IAMExtTransport::GetEditPropertySet