KSPROPSETID_SoundDetector2

KSPROPSETID_SoundDetector2 プロパティ セットには、検出機能もサポートするオーディオ キャプチャ デバイスのフィルターを登録するために使用されるプロパティが含まれています。 フィルターには、ピン カテゴリ KSNODETYPE_AUDIO_KEYWORDDETECTORを持つ KS ピン ファクトリがあります。 特定の KS フィルター インスタンスにこの KS ピン カテゴリを持つ複数のピン ファクトリを指定することはできません。

KSPROPSETID_SoundDetector2 は、Windows 10 バージョン 1903 以降でサポートされています。 KSPROPSETID_SoundDetector2 プロパティ セットは、複数の音声エージェントをサポートするために使用されます。 詳細については、「複数音声アシスタント をする」を参照してください。 KSPROPSETID_SoundDetector プロパティ セットは、Cortana のみをサポートするシステムで使用されます。

KSPROPSETID_SoundDetector2 では、KSPROPERTY ではなく、KSSOUNDDETECTORPROPERTY 構造体を使用します。

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

すべてのKSPROPSETID_SoundDetector2プロパティは、KSSOUNDDETECTORPROPERTY データ構造を使用して呼び出されます。 このデータ構造には、KSPROPERTY と、キーワードが武装、リセット、検出されるイベント ID などが含まれます。

ヘッダー ファイルは、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 イベントです。