KSPROPERTY_AUDIO_FILTER_STATE

KSPROPERTY_AUDIO_FILTER_STATE屬性可用來查詢 GFX 篩選準則，以取得其支援的屬性集清單。 清單會以屬性集 GUID 陣列的形式擷取。

使用量摘要資料表

Get	集合	目標	屬性描述項類型	屬性值類型
是	否	篩選	KSPROPERTY	GUID 的陣列

屬性資料 (作業資料) 是 GUID 陣列。 陣列中的每個 GUID 都會指定篩選準則所支援的屬性集。

傳回值

KSPROPERTY_AUDIO_FILTER_STATE屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。 否則，要求會傳回適當的錯誤狀態碼。

備註

這個屬性所傳回之 GUID 陣列的大小取決於篩選所支援的屬性集數目。 擷取陣列之前，用戶端會先傳送迷你埠驅動程式的屬性處理常式，以零長度屬性值緩衝區傳送KSPROPERTY_AUDIO_FILTER_STATE get-property 要求，以查詢屬性的 GUID 陣列大小。 處理常式會傳回所需的緩衝區大小和狀態碼STATUS_BUFFER_OVERFLOW來回應。 如需詳細資訊，請參閱 音訊屬性處理常式。

透過來自KSPROPERTY_AUDIO_FILTER_STATE get 屬性要求的 GUID 陣列，作業系統可以序列查詢每個屬性集內的屬性。 這項資訊可讓作業系統在篩選具現化時還原 GFX 篩選物件的狀態，以及在篩選終結時儲存 GFX 篩選物件的狀態。 儲存或還原 GFX 篩選準則的狀態時，作業系統會序列化每個屬性集中屬性的要求，如 KS 屬性中所述。 儲存和還原 GFX 篩選準則狀態的目的，是保留使用者對篩選設定所做的任何變更，以及讓設定持續跨篩選準則的後續具現化。 .

規格需求

標頭	Ksmedia.h (包含 Ksmedia.h)

另請參閱

KSPROPERTY