次の方法で共有


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 を返す必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

戻り値 説明
S_OK
関数が正常に終了しました。
E_POINTER
ModelData ポインターが NULL です
E_INVALIDARG
KeywordId パラメーターまたは LangId パラメーターが無効です。
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)
処理を完了できませんでした。
E_HW_RESET
内部障害によるハードウェア リセット。

注釈

ドライバーがキーワード (keyword)ディテクタ ピンからバースト キーワード (keyword)/コマンド ストリームにスポークキーワード (keyword)の任意の部分を含める場合、ドライバーは KeywordEndTime の有効な値を返す必要があります。 それ以外の場合、ドライバーは必要に応じて 0 を返す場合があります。

ドライバーが KeywordStartTime または KeywordEndTime を返す場合、返される値は、ドライバーの IMiniportWaveRTInputStream::GetReadPacket ルーチンから返されるタイム スタンプと一致している必要があります。

ドライバーは、バースト キーワード (keyword)/コマンド ストリームに読み上げられたキーワード (keyword)の任意の部分がドライバーに含まれているかどうかに関係なく、KeywordStartTimeKeywordEndTime の有効な値を返す場合があります。

呼び出し元がE_HW_RESETを受け取った場合、ハードウェアによってキーワード (keyword)が検出されておらず、状態が失われました。 監視状態に戻るには、再アームが必要です。

要件

要件
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー keyworddetectoroemadapter.h

こちらもご覧ください

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IMiniportWaveRTInputStream::GetReadPacket

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

SOUNDDETECTOR_PATTERNHEADER