共用方式為


IAMExtTransport::GetCapability 方法 (strmif.h)

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

方法 GetCapability 會擷取傳輸的一般功能。

語法

HRESULT GetCapability(
  [in]  long   Capability,
  [out] long   *pValue,
  [out] double *pdblValue
);

參數

[in] Capability

指定要檢查的功能。 如需詳細資訊,請參閱「備註」。

[out] pValue

接收 整數之變數的指標。 如需詳細資訊,請參閱「備註」。

[out] pdblValue

接收 雙精度浮點數的變數指標。 如需詳細資訊,請參閱「備註」。

傳回值

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

備註

Capability 參數是一個旗標,指定要檢查的功能。 方法會根據功能旗標,在 pValue 參數或 pdblValue 參數中傳回結果。

針對下列旗標,方法會傳回 pValue 參數中的 OATRUE 或 OAFALSE 值。 OATRUE 值表示功能存在,而 OAFALSE 值表示它不存在。

功能旗標 Description
ED_TRANSCAP_CAN_ASSEMBLE 傳輸可以使用組合記錄模式 (記錄新追蹤,從先前記錄的區段) 順暢地連結至控件追蹤。
ED_TRANSCAP_CAN_BUMP_PLAY 傳輸可以透過不同的速度進行同步處理。
ED_TRANSCAP_CAN_DELAY_AUDIO_IN 傳輸可以執行延遲的音訊編輯。
ED_TRANSCAP_CAN_DELAY_AUDIO_OUT 傳輸可以執行延遲的音訊編輯。
ED_TRANSCAP_CAN_DELAY_VIDEO_IN 傳輸可以執行延遲的視訊編輯。
ED_TRANSCAP_CAN_DELAY_VIDEO_OUT 傳輸可以執行延遲的視訊編輯。
ED_TRANSCAP_CAN_DETECT_LENGTH 傳輸可以偵測媒體的長度。
ED_TRANSCAP_CAN_EJECT 傳輸可能會退出媒體。
ED_TRANSCAP_CAN_FREEZE 傳輸可以凍結/暫停。
ED_TRANSCAP_CAN_INSERT 傳輸可以在鎖定到預先錄製的控制追蹤) 時,使用插入記錄模式 (記錄個別追蹤。
ED_TRANSCAP_CAN_PLAY_BACKWARDS 傳輸可以回溯播放。
ED_TRANSCAP_CAN_SET_EE 傳輸可以在其輸出上顯示裝置的輸入。
ED_TRANSCAP_CAN_SET_PB 傳輸可以在其輸出上顯示媒體播放。
ED_TRANSCAP_FIELD_STEP 傳輸會藉由前進一個字段來回應框架前進命令。
ED_TRANSCAP_HAS_CLOCK 裝置有時鐘。
ED_TRANSCAP_HAS_DT 裝置具有動態追蹤。
ED_TRANSCAP_HAS_TIMER 裝置有定時器。
ED_TRANSCAP_HAS_TUNER 裝置有微調器。
ED_TRANSCAP_IS_MASTER 裝置是同步處理的主要時鐘。
ED_TRANSCAP_MULTIPLE_EDITS 裝置支援多個編輯事件。
ED_TRANSCAP_NEEDS_CUEING 必須先提示裝置才能執行編輯。
ED_TRANSCAP_NEEDS_TBC 必須校正裝置。
 

針對下列旗標,方法會傳回 pValue 參數中的數值。

功能旗標 傳回值
ED_TRANSCAP_LTC_TRACK 傳回 LTC timecode 追蹤的追蹤編號,如果沒有專用的時間碼追蹤,則傳回ED_ALL。
ED_TRANSCAP_NUM_AUDIO_TRACKS 傳回音訊播放軌的數目。
 

針對下列旗標,方法會傳回 pdblValue 參數中的值。

功能旗標 傳回值
ED_TRANSCAP_FWD_SHUTTLE_MAX 在高速模式中,以多次播放速度達到最大向前速度。
ED_TRANSCAP_FWD_SHUTTLE_MIN 以多次播放速度的模式,以最小順向速度表示。
ED_TRANSCAP_FWD_VARIABLE_MAX 向前速度上限,作為播放速度的倍數。
ED_TRANSCAP_FWD_VARIABLE_MIN 最小向前速度,以多次播放速度表示。
ED_TRANSCAP_REV_SHUTTLE_MAX 在高速模式中,以多次播放速度達到最大反向速度。
ED_TRANSCAP_REV_SHUTTLE_MIN 以多部播放速度作為多部播放速度的最小反向速度。
ED_TRANSCAP_REV_VARIABLE_MAX 反向速度上限,為播放速度的倍數。
ED_TRANSCAP_REV_VARIABLE_MIN 最低反向速度,作為播放速度的倍數。
 

DV 實作

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

規格需求

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

另請參閱

錯誤和成功碼

IAMExtTransport 介面