KSPROPERTY_AUDIO_MIX_LEVEL_TABLE
KSPROPERTY_AUDIO_MIX_LEVEL_TABLE 屬性會指定超級混音器節點的混合層級 (KSNODETYPE_SUPERMIX) 。 它會提供所有輸入和輸出通道的資訊。
使用量摘要資料表
| Get | Set | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
是 |
選用 |
Pin |
KSAUDIO_MIXLEVEL結構的陣列 |
需要節點才能實作對KSPROPERTY_TYPE_GET要求的支援。 不過，KSPROPERTY_TYPE_SET要求的支援是選擇性的。
屬性值 (作業資料) 是KSAUDIO_MIXLEVEL結構的陣列，可指定超混音器節點中具有 M 輸入通道和 N 輸出通道之所有 M*N 輸入輸出路徑的混合層級。 陣列包含 M*N 元素：
KSAUDIO_MIXLEVEL MixLevel[M*N];
下表顯示陣列元素與超級混音器節點的 M*N 輸入輸出路徑的對應。
| Array 元素 | Input-Output 路徑 |
|---|---|
MixLevel[0] |
輸入通道 0 至輸出通道 0 |
MixLevel[1] |
輸入通道 0 至輸出通道 1 |
MixLevel[N-1] |
輸入通道 0 至輸出通道 N-1 |
MixLevel[N] |
輸入通道 1 至輸出通道 0 |
MixLevel[N+1] |
輸入通道 1 至輸出通道 1 |
MixLevel[2N-1] |
輸入通道 1 至輸出通道 N-1 |
MixLevel[M*N-1] |
輸入通道 M-1 至輸出通道 N-1 |
下圖說明 MixLevel 陣列元素與輸入輸出路徑的對應。 控制每個輸入輸出路徑的 MixLevel 陣列元素索引會顯示在方括弧中。
如果沒有路徑將輸入通道i連接到輸出通道j，篩選應該將陣列元素 MixLevel[i*N+j] 的Mute成員設定為TRUE。
KSAUDIO_MIXLEVEL陣列的大小是從從KSPROPERTY_AUDIO_MIX_LEVEL_CAPS擷取的KSAUDIO_MIXCAP_TABLE結構計算而來。 如果結構的 InputChannels 和 OutputChannels 成員包含 m 和 n值，則陣列大小為
m * n * sizeof (KSAUDIO_MIXLEVEL)
傳回值
KSPROPERTY_AUDIO_MIX_LEVEL_TABLE屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。 否則，要求會傳回適當的錯誤狀態碼。
備註
篩選會成功KSPROPERTY_AUDIO_MIX_LEVEL_TABLE set-property 要求，該要求會指定KSAUDIO_MIXLEVEL) 超出篩選範圍的混合層級值 (Level 成員，但 (以無訊息方式) 將值限制在支援的範圍。 不過，在取得此屬性的後續要求中，篩選會輸出所使用的實際值。
規格需求
標頭 |
Ksmedia.h (包含 Ksmedia.h) |