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 通知が送信されます。 注: これは IoReportTargetDeviceChangeAsynchronous 経由でペイロードと共に送信される PNP イベントです。