視訊擷取 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
所有篩選和釘選物件在其屬性上都支援基本支援作業。 它們是否支援 get 和 Set 作業取決於 屬性。 屬性,表示篩選或釘選物件的固有功能,可能只需要取得作業。 屬性,表示可設定的設定可能只需要 Set 作業,不過取得作業可能也適用于讀取目前的設定。 如需搭配影片擷取屬性使用取得、設定和基本支援作業的詳細資訊,請參閱 KS 屬性。
每個屬性描述都包含一個表格,指出視訊擷取迷你驅動程式是否必須支援讀取或寫入屬性。 視訊擷取迷你驅動程式應該會傳回STATUS_NOT_SUPPORTED,以回應迷你驅動程式不支援的屬性取得或設定要求。
下列清單描述影片擷取迷你驅動程式所使用的核心串流屬性集:
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
下列屬性集可以與 USB 視訊類別驅動程式搭配使用:
PROPSETID_VIDCAP_CAMERACONTROL