KSPROPERTY_AUDIOLOOPBACK
KSPROPERTY_AUDIOLOOPBACK 屬性會指出回送點是否在磁碟區前或後置和靜音。
從 Windows 11 24H2 開始，設定 KSPROPERTY_AUDIOLOOPBACK 屬性是必要條件。
使用量摘要數據表
| 取得 Yammer | 設定 | Target | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
| 是 | No | 釘選 | KSATTRIBUTE_AUDIOLOOPBACK_TAPPOINT | KSATTRIBUTE 結構 |
KSPROPERTY_AUDIOLOOPBACK是與KSPROPSETID_AudioLoopback相關聯的屬性列舉，並實作下列屬性。
typedef enum {
KSPROPERTY_AUDIOLOOPBACK_TAPPOINT_CAPS,
} KSPROPERTY_AUDIOLOOPBACK;
Windows AudioEndpointBuilder 使用 KSPROPSETID_AudioLoopback 搭配 KSPROPERTY_AUDIOLOOPBACK_TAPPOINT_CAPS 來撷取 AUDIOLOOPBACK_TAPPOINT_CAPS_<*>。 這會通知操作系統音訊端點是否能夠執行音量回送、回傳音量後回送或兩者。
稍後，在針腳建立時，OS 會提供屬性，KSATTRIBUTEID_AUDIOLOOPBACK_TAPPOINT搭配KSATTRIBUTE_AUDIOLOOPBACK_TAPPOINT，以傳達是否要建立回送針腳做為磁碟區前或後置磁碟區。
點選點上限的定義如下。
#define AUDIOLOOPBACK_TAPPOINT_CAPS_PREVOLUMEMUTE (0x1)
#define AUDIOLOOPBACK_TAPPOINT_CAPS_POSTVOLUMEMUTE (0x2)
ksmedia.h 中可用的KSATTRIBUTE_AUDIOLOOPBACK_TAPPOINT結構可以提供包裝函式，以指定要點選數據流圖形中回送位置的AUDIO_LOOPBACK_TAPPOINT_TYPE屬性。
傳回值
KSPROPERTY_AUDIOLOOPBACK屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。 否則，要求會傳回適當的錯誤狀態代碼。
備註
音訊系統可以摘要如下。
- 訊號處理輸出：從卸除或直接從主機提供者卸載或直接處理的訊號輸出。
- 音量：流程中的下一個步驟，其中已調整音訊號的音量。
- 靜音：此階段會視需要將音訊號靜音。
- EFX （效果）：在這裡，效果會套用至音訊訊號。
- 輸出：輸出已處理音訊號的最後階段。
具有硬體音訊引擎的系統必須實作回送釘選。 套用所有訊號處理之後，回送針腳會傳回混合音訊輸出。
回送數據流也會受到端點磁碟區和靜音的影響。 此屬性可讓應用程式選擇應該在套用端點磁碟區和靜音之前或之後傳回回回數據流。
音訊驅動程式必須將 Audio Engine 輸出釘選連接到 Filter 的回送針腳。 回送針腳必須將類別公告為KSNODETYPE_AUDIO_LOOPBACK。 回送不會實作訊號處理模式。
OS 可以查詢音訊驅動程式以取得回送點點功能。 功能會以旗標的位掩碼傳回。
在回送針腳上建立的數據流會收集與 DSP 混合的輸出，並將它作為擷取數據流傳回 OS。 驅動程式從OS取得選項的其中一種方式是透過串流屬性。 如果未將任何屬性套用至回送數據流，則應該先收集回送，再對混音器輸出套用靜音。
針對使用者模式用戶端，在呼叫 SetClientProperties 時，會透過AUDCLNT_STREAMOPTIONS_POST_VOLUME_LOOPBACK完成磁碟區回送和後磁碟區回送之間的切換，以 AUDCLNT_STREAMOPTIONS （audioclient.h） 的形式傳入。
KSNODETYPE_AUDIO_LOOPBACK
KSNODETYPE_AUDIO_LOOPBACK代表音訊回送功能。 它定義於 ksmedia.h 中，如下所示。
#define STATIC_KSNODETYPE_AUDIO_LOOPBACK\
0x8f42c0b2, 0x91ce, 0x4bcf, 0x9c, 0xcd, 0xe, 0x59, 0x90, 0x37, 0xab, 0x35
DEFINE_GUIDSTRUCT("8F42C0B2-91CE-4BCF-9CCD-0E599037AB35", KSNODETYPE_AUDIO_LOOPBACK);
#define KSNODETYPE_AUDIO_LOOPBACK DEFINE_GUIDNAMED(KSNODETYPE_AUDIO_LOOPBACK)
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 11 版本 24H2 |
| 頁首 | Ksmedia.h |