Metode IKeywordDetectorOemAdapter::P arseDetectionResultData (keyworddetectoroemadapter.h)

Metode ParseDetectionResultData dipanggil oleh sistem operasi setelah menangani peristiwa deteksi kata kunci dan setelah mengambil data hasil dari KSPROPERTY_SOUNDDETECTOR_MATCHRESULT. Sistem operasi meneruskan data hasil kecocokan khusus OEM ke metode ini untuk mendapatkan hasil deteksi kata kunci. OEMDLL memproses hasil dan mengembalikan informasi tentang kata kunci yang cocok, bahasa yang terkait dengan kata kunci yang cocok, dan pengguna yang cocok (jika ada).

Sintaks

HRESULT ParseDetectionResultData(
  [in]  IStream                     *UserModelData,
  [in]  SOUNDDETECTOR_PATTERNHEADER *Result,
  [out] KEYWORDID                   *KeywordId,
  [out] LANGID                      *LangId,
  [out] BOOL                        *pIsUserMatch,
  [out] ULONG64                     *KeywordStartPerformanceCounterValue,
  [out] ULONG64                     *KeywordEndPerformanceCounterValue
);

Parameter

[in] UserModelData

Penunjuk ke IStream terikat ke data model untuk pola arming.

[in] Result

Pointer ke SOUNDDETECTOR_PATTERNHEADER dari DDI.

[out] KeywordId

Mengidentifikasi fungsi kata kunci. Driver dapat mengembalikan 0 untuk menunjukkan tidak ada kecocokan.

[out] LangId

Mengidentifikasi bahasa.

[out] pIsUserMatch

Menunjukkan apakah pengguna cocok.

[out] KeywordStartPerformanceCounterValue

Secara opsional mengembalikan waktu mulai kata kunci dalam hal penghitung kinerja Windows. OEMDLL harus mengembalikan 0 jika ini tidak tersedia.

[out] KeywordEndPerformanceCounterValue

Secara opsional mengembalikan waktu akhir kata kunci dalam hal penghitung kinerja Windows. OEMDLL harus mengembalikan 0 jika ini tidak tersedia.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan nilai Deskripsi
S_OK
Fungsi berhasil keluar.
E_POINTER
Penunjuk ModelData adalah NULL.
E_INVALIDARG
Parameter KeywordId atau LangId tidak valid.
HRESULT_FROM_WIN32(ERROR_GEN_FAILURE)
Pemrosesan tidak dapat diselesaikan.
E_HW_RESET
Reset perangkat keras karena kesalahan internal.

Keterangan

Jika driver menyertakan bagian apa pun dari kata kunci lisan dalam aliran kata kunci/perintah burst dari pin detektor kata kuncinya, maka driver harus mengembalikan nilai yang valid untuk KeywordEndTime. Jika tidak, driver dapat secara opsional mengembalikan 0.

Jika driver mengembalikan KeywordStartTime atau KeywordEndTime, nilai yang dikembalikan harus konsisten dengan stempel waktu yang dikembalikan dari rutinitas IMiniportWaveRTInputStream::GetReadPacket driver.

Driver dapat mengembalikan nilai yang valid untuk KeywordStartTime dan KeywordEndTime terlepas dari apakah driver menyertakan bagian apa pun dari kata kunci lisan dalam kata kunci burst/aliran perintah.

Jika penelepon menerima E_HW_RESET, tidak ada kata kunci yang terdeteksi oleh perangkat keras dan status hilang. Lengan ulang akan diperlukan untuk kembali ke status pemantauan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Header kata kuncidetectoroemadapter.h

Lihat juga

CoTaskMemAlloc

CoTaskMemFree

IKeywordDetectorOemAdapter

IMiniportWaveRTInputStream::GetReadPacket

KSPROPERTY_SOUNDDETECTOR_MATCHRESULT

SOUNDDETECTOR_PATTERNHEADER