AcxKeywordSpotterCreate (acxelements.h)
Fungsi AcxKeywordSpotterCreate digunakan untuk membuat objek spotter kata kunci ACX yang akan dikaitkan dengan induk objek perangkat sirkuit.
Sintaks
NTSTATUS AcxKeywordSpotterCreate(
ACXCIRCUIT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_KEYWORDSPOTTER_CONFIG Config,
ACXKEYWORDSPOTTER *KeywordSpotter
);
Parameter
Object
Objek WDFDEVICE (dijelaskan dalam Ringkasan Objek Kerangka Kerja) yang akan dikaitkan dengan sirkuit.
Attributes
Atribut Tambahan yang ditentukan menggunakan struktur WDF_OBJECT_ATTRIBUTES yang digunakan untuk mengatur berbagai nilai dan untuk mengaitkan objek KeywordSpotter dengan objek perangkat WDF induk.
Config
Struktur ACX_KEYWORDSPOTTER_CONFIG yang diinisialisasi yang menjelaskan konfigurasi spotter kata kunci.
KeywordSpotter
Penunjuk ke lokasi yang menerima handel ke objek ACXKEYWORDSPOTTER yang baru dibuat. Untuk informasi selengkapnya tentang objek ACX, lihat Ringkasan Objek ACX.
Menampilkan nilai
Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.
Keterangan
Contoh
Contoh penggunaan ditunjukkan di bawah ini.
ACX_KEYWORDSPOTTER_CALLBACKS_INIT(&keywordSpotterCallbacks);
keywordSpotterCallbacks.EvtAcxKeywordSpotterRetrieveArm = CodecC_EvtAcxKeywordSpotterRetrieveArm;
keywordSpotterCallbacks.EvtAcxKeywordSpotterAssignArm = CodecC_EvtAcxKeywordSpotterAssignArm;
keywordSpotterCallbacks.EvtAcxKeywordSpotterAssignPatterns = CodecC_EvtAcxKeywordSpotterAssignPatterns;
keywordSpotterCallbacks.EvtAcxKeywordSpotterAssignReset = CodecC_EvtAcxKeywordSpotterAssignReset;
ACX_KEYWORDSPOTTER_CONFIG_INIT(&keywordSpotterCfg);
keywordSpotterCfg.Pattern = &CONTOSO_KEYWORDCONFIGURATION_IDENTIFIER2;
keywordSpotterCfg.Callbacks = &keywordSpotterCallbacks;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_KEYWORDSPOTTER_CONTEXT);
attributes.ParentObject = Circuit;
status = AcxKeywordSpotterCreate(Circuit, &attributes, &keywordSpotterCfg, Element);
Persyaratan ACX
Versi ACX minimum: 1.0
Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |