KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

發行項
06/15/2023

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL屬性會指定指定資料流程中通道的磁片區層級。

使用量摘要表格

Get	集合	目標	屬性描述元類型	屬性值類型
是	是	透過 Pin 實例的節點	KSNODEPROPERTY_AUDIO_CHANNEL	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的通道值表示要求適用于所有通道。如果在資料流程未處於執行狀態時提出屬性要求，則會立即將磁片區層級設定為要求的層級。如果資料流程在磁片區層級坡形正在進行時離開執行狀態，資料流程的磁片區層級會立即設定為目前淡出的目標層級。如果在進行現有磁片區層級坡形時提出新的屬性要求，則新的坡形要求必須從目前的磁片區層級開始，也就是新要求抵達時磁片區已達到的層級。