KSPROPSETID_SoundDetector2

屬性 KSPROPSETID_SoundDetector2 集包含的屬性，可用來註冊也支援偵測器之音訊擷取裝置的篩選。 篩選準則具有具有針腳類別 KSNODETYPE_AUDIO_KEYWORDDETECTOR的 KS 針腳處理站。 指定的 KS 篩選實例中不能有一個以上的針腳處理站具有此 KS 針腳類別。

KSPROPSETID_SoundDetector2Windows 10 1903 版和更新版本支援。 KSPROPSETID_SoundDetector2屬性集是用來支援多個語音代理程式。 如需詳細資訊，請參閱 Multiple Voice Assistant。 KSPROPSETID_SoundDetector 屬性集用於僅支援 Cortana 的系統上。

KSPROPSETID_SoundDetector2 會使用 KSSOUNDDETECTORPROPERTY 結構，而不是 KSPROPERTY：

typedef struct {
    KSPROPERTY  Property;
    GUID        EventId;
} KSSOUNDDETECTORPROPERTY, *PKSSOUNDDETECTORPROPERTY;

所有KSPROPSETID_SoundDetector2屬性都會使用 KSSOUNDDETECTORPROPERTY 資料結構來呼叫。 此資料結構包含 KSPROPERTY，以及要啟動、重設、偵測到等關鍵字的事件識別碼。

標頭檔會定義 KSPROPSETID_SoundDetector2 屬性集，如下所示：

#define STATIC_KSPROPSETID_SoundDetector2\
    0xfe07e322, 0x450c, 0x4bd5, 0x84, 0xca, 0xa9, 0x48, 0x50, 0xe, 0xa6, 0xaa
DEFINE_GUIDSTRUCT("FE07E322-450C-4BD5-84CA-A948500EA6AA", KSPROPSETID_SoundDetector2);

屬性 KSPROPSETID_SoundDetector2 集包含下列屬性：

• KSPROPERTY_SOUNDDETECTOR_SUPPORTEDPATTERNS - 這個屬性是由作業系統設定，以設定要偵測的關鍵字。

• KSPROPERTY_SOUNDDETECTOR_PATTERNS - 驅動程式的 KS 篩選器支援此讀取/寫入屬性。 OS 會設定此屬性，以設定要偵測的關鍵字。

• KSPROPERTY_SOUNDDETECTOR_ARMED - 這個讀取/寫入屬性只是布林值狀態，指出偵測器是否處於啟動狀態。 OS 會將此設定為與關鍵字偵測器互動。 OS 可以清除此動作來脫離。 當設定關鍵字模式時，驅動程式也會在偵測到關鍵字之後自動清除此功能。 (OS 必須重新排列。)

• KSPROPERTY_SOUNDDETECTOR_RESET - 將偵測器重設為未設定模式的未受防護狀態。

• KSPROPERTY_SOUNDDETECTOR_STREAMINGSUPPORT - 未來僅用於語音偵測器。 失敗此要求，指出不支援或成功屬性，並傳回所有其他驅動程式的 true。

在關鍵字偵測時間，會傳送包含KSNOTIFICATIONID_SoundDetector的 PNP 通知。 注意：這不是 KSEvent，而是透過 IoReportTargetDeviceChangeAsynchronous傳送的 PNP 事件。