KSPROPERTY_AUDIOENGINE_VOLUMELEVEL
KSPROPERTY_AUDIOENGINE_VOLUMELEVEL屬性會指定指定資料流程中通道的磁片區層級。
使用量摘要表格
| Get | 集合 | 目標 | 屬性描述元類型 | 屬性值類型 |
|---|---|---|---|---|
是 |
是 |
透過 Pin 實例的節點 |
Get 要求) 的 LONG (，以及 Set 要求) 的 KSAUDIOENGINE_VOLUMELEVEL (。 |
針對 Get 要求，屬性值的類型為 LONG，它會指定指定資料流程中通道的磁片區層級。 磁片區層級值會使用下列小數位數，而且可以系結于此屬性的基本支援回應中提供的最小值和最大值：
-2147483648 (0x80000000十六進位，或LONG_MIN) 為 -Infinity decibels (衰減) ，
-2147483647 (0x80000001十六進位或LONG_MIN + 1) 為 -32767.99998474 減號 (衰減) 和
十六進位或LONG_MAX) 的 +2147483647 (0x7FFFFFFF 為 +32767.99998474 decibels (取得) 。
注意
小數位數範圍是以介於 -2147483648 到 +2147483647的整數值表示，其中此小數位數的解析度為 1/65536 分貝。
對於 Set 要求，屬性值的類型為 KSAUDIOENGINE_VOLUMELEVEL，它會指定指定資料流程中通道所需的磁片區層級，以及設定磁片區層級時要套用的曲線類型和曲線持續時間。 如果指定超出篩選範圍的值，則設定此屬性的要求仍會成功。 但套用至篩選的實際值只能由後續的 Get 呼叫來決定。
傳回值
KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。 否則，要求會傳回適當的錯誤狀態碼。
備註
KSPROPERTY_AUDIOENGINE_VOLUMELEVEL的屬性描述元會指定通道編號。 如果通過音訊引擎節點的資料流程包含 n 個通道，則通道編號為 0 到 n-1。 另請注意，0xFFFFFFFF的通道值表示要求適用于所有通道。 如果在資料流程未處於執行狀態時提出屬性要求，則會立即將磁片區層級設定為要求的層級。 如果資料流程在磁片區層級坡形正在進行時離開執行狀態，資料流程的磁片區層級會立即設定為目前淡出的目標層級。 如果在進行現有磁片區層級坡形時提出新的屬性要求，則新的坡形要求必須從目前的磁片區層級開始，也就是新要求抵達時磁片區已達到的層級。
規格需求
版本 |
Windows 8 |
標頭 |
Ksmedia.h |