共用方式為


Encoder 屬性集

本節說明編碼器和編解碼器 API 特定屬性集,這些屬性集適用于在 Microsoft Windows 98/Me、Windows 2000 和 Windows XP 和更新版本中使用 WDM 核心串流服務的編碼器迷你驅動程式。

每個屬性的參考頁面都包含具有資料行標題的資料表,如下所示。

Get 集合 目標 屬性描述項類型 屬性值類型

這些標題具有下列意義:

  • Get

    目標 KS 物件是否支援KSPROPERTY_TYPE_GET屬性要求?

  • 設定

    目標 KS 物件是否支援KSPROPERTY_TYPE_SET屬性要求?

  • Target

    這是傳送屬性要求的 KS 物件。 視訊編碼器屬性的目標為篩選準則或釘選。 (屬性要求會依其核心 handle 指定目標物件。)

  • 屬性描述項類型

    屬性描述項會指定要在該屬性上執行的屬性和作業。 描述項一律以 KSPROPERTY 結構開頭。

  • 屬性值類型

    屬性具有值,且此值的類型取決於 屬性。 例如,一個屬性只能處於兩個狀態之一:開啟或關閉,通常具有 BOOL 值。 可以假設整數值從 0x0 到 0xFFFFFFFF 的屬性可能會有 ULONG 值。 更複雜的屬性可能會有陣列或結構的值。

上述屬性描述項和屬性值是 KS 屬性、事件和方法中所討論之實例規格和作業資料緩衝區的屬性特定版本。

屬性要求會使用下列其中一個旗標來指定要在 屬性上執行的作業:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

所有篩選和釘選物件在其屬性上都支援基本支援作業。 它們是否支援 getSet 作業取決於 屬性。 屬性,表示篩選或釘選物件的固有功能,可能只需要 取得 作業。 屬性,表示可設定的設定可能只需要 Set 作業,不過 取得 作業可能也適用于讀取目前的設定。 如需搭配視訊編碼器屬性使用取得、設定和基本支援作業的詳細資訊,請參閱 KS 屬性

每個屬性描述中的表格會指出是否需要視訊編碼器迷你驅動程式,才能支援讀取或寫入屬性。 視訊編碼器迷你驅動程式應該會傳回STATUS_NOT_SUPPORTED,以回應迷你驅動程式不支援的屬性取得或設定要求。

下列屬性會設定每個屬性都包含必須由視訊編碼器迷你驅動程式實作的單一屬性。 也就是說,實際上每個屬性都會取得自己的集合,因此請視需要在KSPROPERTY_SET結構中KSPROPERTY_ITEM成員的PropertyId成員中指定 0。

下列屬性集屬於編解碼器 API:

CODECAPI_VIDEO_ENCODER

CODECAPI_AUDIO_ENCODER

CODECAPI_SETALLDEFAULTS

CODECAPI_ALLSETTINGS

CODECAPI_SUPPORTSEVENTS

CODECAPI_CURRENTCHANGELIST

下列屬性集屬於編碼器 API:

ENCAPIPARAM_BITRATE

ENCAPIPARAM_BITRATE_MODE

ENCAPIPARAM_PEAK_BITRATE