IKeywordDetectorOemAdapter::P arseDetectionResultData メソッド (keyworddetectoroemadapter.h)
ParseDetectionResultData メソッドは、キーワード検出イベントを処理した後、KSPROPERTY_SOUNDDETECTOR_MATCHRESULTから結果データを取得した後に、オペレーティング システムによって呼び出されます。 オペレーティング システムは、キーワード検出の結果を取得するために、OEM 固有の一致結果データをこのメソッドに渡します。 OEMDLL は結果を処理し、一致したキーワード、一致したキーワードに関連付けられている言語、および一致したユーザー (存在する場合) に関する情報を返します。
構文
HRESULT ParseDetectionResultData(
[in] IStream *UserModelData,
[in] SOUNDDETECTOR_PATTERNHEADER *Result,
[out] KEYWORDID *KeywordId,
[out] LANGID *LangId,
[out] BOOL *pIsUserMatch,
[out] ULONG64 *KeywordStartPerformanceCounterValue,
[out] ULONG64 *KeywordEndPerformanceCounterValue
);
パラメーター
[in] UserModelData
IStream へのポインター、アーミング パターンのモデル データにバインドされます。
[in] Result
DDI からの SOUNDDETECTOR_PATTERNHEADER へのポインター。
[out] KeywordId
キーワード関数を識別します。 ドライバーは、一致がないことを示す 0 を返す場合があります。
[out] LangId
言語を識別します。
[out] pIsUserMatch
ユーザーが一致したかどうかを示します。
[out] KeywordStartPerformanceCounterValue
必要に応じて、Windows パフォーマンス カウンターの観点からキーワードの開始時刻を返します。 使用できない場合、OEMDLL は 0 を返す必要があります。
[out] KeywordEndPerformanceCounterValue
必要に応じて、Windows パフォーマンス カウンターの観点からキーワードの終了時刻を返します。 使用できない場合、OEMDLL は 0 を返す必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 戻り値 | 形容 |
|---|---|
|
関数が正常に終了しました。 |
|
ModelData ポインターは NULL です。 |
|
KeywordId または LangId パラメーター が無効です。 |
|
処理を完了できませんでした。 |
|
内部障害によるハードウェア リセット。 |
備考
ドライバーのキーワード検出ピンからバースト キーワード/コマンド ストリームに音声キーワードの一部が含まれている場合、ドライバーは、KeywordEndTime 有効な値を返す必要があります。 それ以外の場合、ドライバーは必要に応じて 0 を返します。
ドライバーが KeywordStartTime または KeywordEndTime 返す場合、返される値は、ドライバーの IMiniportWaveRTInputStream::GetReadPacket ルーチンから返されるタイムスタンプと一致している必要があります。
ドライバーは、KeywordStartTime と KeywordEndTime の有効な値を返す場合があります。これは、ドライバーがバースト キーワード/コマンド ストリームに読み上げられたキーワードの任意の部分を含むかどうかに関係なくです。
呼び出し元が E_HW_RESETを受け取った場合、ハードウェアによってキーワードが検出されておらず、状態が失われました。 監視状態に戻るには、再アームが必要です。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 |
| サポートされる最小サーバー | Windows Server 2016 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | keyworddetectoroemadapter.h |
関連項目
IKeywordDetectorOemAdapter の
IMiniportWaveRTInputStream::GetReadPacket