KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED
KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED, 是已新增至 Windows 8.1 中設定的 KSPROPSETID_Audio 屬性的新 KS 屬性。
KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED屬性要求會將終端使用者的磁片區層級限制喜好設定傳遞給基礎驅動程式。 此屬性的範圍是從使用者的觀點來看,每個釘選 (或每個音訊端點) 。
使用量摘要資料表
Get | 集合 | 目標 | 屬性描述項類型 | 屬性值類型 |
---|---|---|---|---|
否 |
是 |
釘選實例 |
KSP_PIN |
BOOL |
屬性值的類型為 BOOL,指出使用者是否允許最大磁片區超過特定限制。 TRUE 值表示終端使用者已允許磁片區層級超過張貼的限制,而 FALSE 則表示相反。 在子帳戶的情況下,此值一律為 FALSE。
驅動程式會將此屬性的值儲存在內部變數中,並在啟動期間將值初始化為 TRUE。 雖然此屬性為 TRUE,但驅動程式會限制磁片區層級上限。 當 屬性設定為 FALSE 時,驅動程式可以移除這些限制。
驅動程式也可以自動變更此屬性的值。 例如,驅動程式可以自動將屬性值從 TRUE 切換為 FALSE,然後在超過特定聲音等級的某個時間量之後開始限制音量層級。
每當屬性的值變更時,不論它是自動還是因為呼叫端設定屬性值,驅動程式都應該產生KSEVENT_PINCAPS_VOLUMELIMITCHANGE事件。
傳回值
當要求成功時,KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED屬性要求會傳回STATUS_SUCCESS。
規格需求
版本 |
Windows 8.1 |
標頭 |
Ksmedia.h (包含 Ksmedia.h) |