共用方式為

IAMExtTransport：：SetTransportBasicParameters 方法 (strmif.h)

  • 發行項

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

方法 SetTransportBasicParameters 會設定傳輸的一般屬性。

語法

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

參數

[in] Param

指定要設定的屬性。 如需詳細資訊，請參閱「備註」。

[in] Value

將屬性的值指定為 長 整數。 如需詳細資訊，請參閱「備註」。

[in] pszData

將屬性的值指定為 LPOLESTR。 如需詳細資訊，請參閱「備註」。

傳回值

當此方法成功時，它會傳回S_OK。 否則會傳回 HRESULT 錯誤碼。 可能的錯誤碼包括下列專案。

傳回碼 Description
E_NOTIMPL
 裝置不支援設定此屬性。
ERROR_DEVICE_REMOVED
 裝置已移除。

備註

Param 參數是一個旗標，指定要設定的屬性。 對於某些旗標，屬性是數值;使用 Value 參數來指定值。 對於其他旗標，屬性是字串;使用 pszData 參數來指定值。 不論是哪一種情況，方法都忽略另一個參數。

針對下列旗標， Value 參數會採用定義的常數。

  • ED_TRANSBASIC_TIME_FORMAT：指定時間格式。
    常數 描述
    ED_FORMAT_MILLISECONDS 毫秒。
    ED_FORMAT_FRAMES 框架。
    ED_FORMAT_REFERENCE_TIME 參考時間。
    ED_FORMAT_HMSF 二進位編碼十進位，代表小時、分鐘、秒和畫面格。
    ED_FORMAT_TMSF 二進位編碼十進位，代表曲目、分鐘、秒和畫面格。
     
  • ED_TRANSBASIC_TIME_REFERENCE：指定裝置使用的參考時間。
    常數 描述
    ED_TIMEREF_TIMECODE 時間程序代碼。
    ED_TIMEREF_CONTROL_TRACK 控制追蹤。
    ED_TIMEREF_INDEX 索引。
    ED_TIMEREF_ATN 絕對追蹤編號。 這個常數定義於頭檔 Xprtdefs.h 中。
     
  • ED_TRANSBASIC_END_STOP_ACTION：指定裝置到達傳輸媒體結束時所採取的動作。
    常數 描述
    ED_MODE_STOP 停止。
    ED_MODE_REWIND 倒。
    ED_MODE_FREEZE 凍結/暫停。
     
  • ED_TRANSBASIC_RECORD_FORMAT：指定錄製速度。
    常數 描述
    ED_RECORD_FORMAT_SP 標準播放。
    ED_RECORD_FORMAT_LP 長時間播放。
    ED_RECORD_FORMAT_EP 延伸播放。
     
  • ED_TRANSBASIC_SUPERIMPOSE：指定是否啟用或停用屏幕顯示。
    常數 描述
    OATRUE 屏幕顯示已啟用。
    OAFALSE 屏幕顯示已停用。
     
  • ED_TRANSBASIC_STEP_UNIT：指定步驟單位。
    常數 描述
    ED_STEP_FIELD 欄位。
    ED_STEP_FRAME 框架。
    ED_STEP_3_2 3/2 下拉。
     
  • ED_TRANSBASIC_SET_COUNTER_FORMAT：設定計數器的時間格式。 如需可能的值，請參閱ED_TRANSBASIC_TIME_FORMAT旗標。
針對下列旗標，請使用 Value 參數中的數值。
旗標 描述
ED_TRANSBASIC_STEP_COUNT 以ED_TRANSBASIC_STEP_UNIT旗標所定義的單位指定步驟計數。
ED_TRANSBASIC_SET_FREEZE_TIMEOUT 以目前時間格式的單位指定凍結模式的逾時。
ED_TRANSBASIC_SETCLOCK 設定時鐘時間。
ED_TRANSBASIC_SET_COUNTER_VALUE 設定計數器的值。
 

針對下列旗標，請使用 pszData 參數中的字串。

旗標 描述
ED_TRANSBASIC_VOLUME_NAME 指定磁碟區名稱。
 

DV 實作

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

規格需求

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

另請參閱

錯誤和成功碼

IAMExtTransport 介面

IAMExtTransport：：GetTransportBasicParameters