共用方式為


視訊擷取 Minidriver 屬性集

本節說明影片擷取特定屬性集,這些屬性集適用于在 Microsoft Windows XP、Windows 2000 和 Windows 98/Me 和更新版本的作業系統中使用 WDM 核心串流服務的視訊擷取迷你驅動程式。

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

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

這些標題具有下列意義:

  • Get

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

  • 設定

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

  • Target

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

  • 屬性描述項類型

    屬性描述項會指定要在該屬性上執行的屬性和作業。 描述項一律以 KSPROPERTY 結構開頭,但某些類型的描述元包含其他資訊。 例如, KSNODEPROPERTY 結構是以 KSPROPERTY 結構開頭的屬性描述元,但也包含節點識別碼。

  • 屬性值類型

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

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

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

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

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

每個屬性描述都包含一個表格,指出視訊擷取迷你驅動程式是否必須支援讀取或寫入屬性。 視訊擷取迷你驅動程式應該會傳回STATUS_NOT_SUPPORTED,以回應迷你驅動程式不支援的屬性取得或設定要求。

下列清單描述影片擷取迷你驅動程式所使用的核心串流屬性集:

PROPSETID_ALLOCATOR_CONTROL

PROPSETID_EXT_DEVICE

PROPSETID_EXT_TRANSPORT

PROPSETID_TIMECODE_READER

PROPSETID_TUNER

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_CROSSBAR

PROPSETID_VIDCAP_DROPPEDFRAMES

PROPSETID_VIDCAP_TVAUDIO

PROPSETID_VIDCAP_VIDEOCOMPRESSION

PROPSETID_VIDCAP_VIDEOCONTROL

PROPSETID_VIDCAP_VIDEODECODER

PROPSETID_VIDCAP_VIDEOPROCAMP

下列屬性集可以與 USB 視訊類別驅動程式搭配使用:

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_VIDEOPROCAMP

PROPSETID_VIDCAP_SELECTOR