共用方式為


IAMExtTransport::SetEditProperty 方法 (strmif.h)

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼,以使用新的 API。]

方法 SetEditProperty 會定義與編輯事件相關聯的參數和值。

這個方法尚未實作。

語法

HRESULT SetEditProperty(
  [in] long EditID,
  [in] long Param,
  [in] long Value
);

參數

[in] EditID

指定編輯屬性集。 使用 IAMExtTransport::SetEditPropertySet 方法傳回的標識碼。

[in] Param

指定編輯事件參數。 如需詳細資訊,請參閱「備註」。

[in] Value

指定參數的值。 如需詳細資訊,請參閱「備註」。

傳回值

當此方法成功時,它會傳回S_OK。 否則會傳回 HRESULT 錯誤碼。

備註

編輯事件是由一或多個編輯事件參數所組成。 使用 SetEditPropertySet 方法來建立編輯事件,然後使用這個方法來指定該編輯事件的編輯事件參數。

Param 參數是指定編輯事件參數的旗標。 Value 參數會指定該參數的值。 Value 的意義取決於 Param 中使用的旗標:

  • ED_EDIT_HEVENT:事件的句柄。 裝置會在編輯事件完成時發出訊號。
  • ED_EDIT_IMMEDIATE:如果值為 OATRUE,應用程式可以使用值 呼叫 IAMExtTransport::p ut_Mode ,將裝置切換為編輯模式ED_MODE_EDIT_CUE。
  • ED_EDIT_MODE:指定編輯模式。 使用下列其中一個常數。
    常數 描述
    ED_EDIT_MODE_ASSEMBLE 組合編輯模式。
    ED_EDIT_MODE_INSERT 插入編輯模式。
    ED_EDIT_MODE_CRASH_RECORD 損毀記錄模式。
     
  • ED_EDIT_TRACK:指定要編輯的追蹤。 使用下列一或多個常數。 您可以將常數與位 OR 結合。
    常數 描述
    ED_VIDEO 視訊播放軌
    透過ED_AUDIO_24 ED_AUDIO_1 曲目 1 到 24
    ED_AUDIO_ALL 所有音訊播放軌
     
  • ED_EDIT_SRC_INPOINT:以目前時間格式的單位指定來源上的 inpoint。
  • ED_EDIT_SRC_OUTPOINT:以目前時間格式的單位指定來源的輸出點。
  • ED_EDIT_REC_INPOINT:以目前時間格式單位指定記錄裝置上的 inpoint。
  • ED_EDIT_REC_OUTPOINT:以目前時間格式的單位指定記錄裝置上的輸出點。
  • ED_EDIT_REHEARSE_MODE:指定預覽模式。 使用下列其中一個常數。
    常數 描述
    ED_EDIT_BVB 黑色視訊-黑色 (BVB) 。 顯示黑色,然後插入視訊,再顯示黑色。
    ED_EDIT_VBV Video-black-video (VBV) 。 顯示錄製的視訊,然後顯示黑色,然後錄製的視訊。
    ED_EDIT_VVV Video-video-video (VVV) 。 顯示錄製的視訊,然後插入視訊,然後錄製視訊。
    ED_EDIT_PERFORM 請勿預覽。
     
  • ED_EDIT_ABORT:使用 OATRUE 值時,此方法會在目前正在進行時停止編輯。
  • ED_EDIT_TIMEOUT:指定裝置在逾時之前等待編輯完成的時間長度。
  • ED_EDIT_SEEK:使用 OATRUE 值時,方法會搜尋指定的點。 請先使用 ED_EDIT_SEEK_MODE 旗標呼叫這個方法,以指定搜尋點。
  • ED_EDIT_SEEK_MODE:指定搜尋點。 使用下列其中一個常數。
    常數 描述
    ED_EDIT_SEEK_EDIT_IN 搜尋至 inpoint。
    ED_EDIT_SEEK_EDIT_OUT 搜尋到 outpoint。
    ED_EDIT_SEEK_PREROLL 搜尋至內點預先註冊。
    ED_EDIT_SEEK_PREROLL_CT 使用 timecode 搜尋至 inpoint,然後使用控件播放軌回到預先註冊點。
    ED_EDIT_SEEK_BOOKMARK 搜尋下一個書籤。
     

DV 實作

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

規格需求

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

另請參閱

錯誤和成功碼

IAMExtTransport 介面

IAMExtTransport::GetEditProperty