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