KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE
KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE 屬性會建立新的虛擬來源。
使用量摘要表格
Get | 集合 | 目標 | 屬性描述元類型 | 屬性值類型 |
---|---|---|---|---|
是 |
否 |
篩選 |
ULONG |
屬性描述元 (實例資料) 是類型SYSAUDIO_CREATE_VIRTUAL_SOURCE結構,指定虛擬來源的針腳類別和釘選名稱 GUID。
(作業資料) 屬性值是包含虛擬來源索引的 ULONG 變數。 SysAudio 會產生此索引來識別新的虛擬來源。
傳回值
KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE屬性要求會傳回STATUS_SUCCESS,表示它已順利完成。 否則,要求會傳回適當的錯誤狀態碼。
備註
這個屬性可用來建立混合器線虛擬來源,例如磁片區或靜音控制項。
如果 SysAudio 已經建立具有相同針腳類別和釘選名稱 GUID 的虛擬來源,KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE get-property 要求會擷取現有虛擬來源的索引。 否則,要求會產生新的虛擬來源索引,並輸出該值。
在 SysAudio 將索引指派給虛擬來源之後,可以使用 KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCEset-property 要求,將該虛擬來源附加至虛擬音訊裝置上的釘選實例。
使用者透過 SndVol32 應用程式控制各種音訊來源的音量層級。 這些來源包括波浪輸出裝置、MIDI 合成器、CD 播放機和行入插孔。 SndVol32 使用 Windows 多媒體 waveOutXxx、 midiOutXxx和 auxXxx 函式來控制這些來源的磁片區層級。 如需 Windows 多媒體函式的詳細資訊,請參閱Microsoft Windows SDK檔。
SysAudio 會攔截對這些裝置所做的磁片區變更,並將其套用至其虛擬來源。 例如,如果將 MIDI 檔案轉換成波浪資料的軟體 MIDI 合成器已連線到其中一個虛擬音訊裝置的波浪轉譯針腳,SysAudio 會將 midiOutXxx 磁片區變更套用至針腳 (,而不是 waveOutXxx 磁片區變更) 。 同樣地,如果 Redbook 系統驅動程式會將數位音訊從 CD 播放程式轉換成波浪資料,則會連線到其中一個虛擬音訊裝置的波浪轉譯針腳,SysAudio 會將AUXCAPS_CDAUDIO音量變更套用至針腳。 如需 AUXCAPS_CDAUDIO 結構的詳細資訊,請參閱 Windows SDK 檔。
規格需求
標頭 |
Ksmedia.h (包含 Ksmedia.h) |