AcxKeywordSpotterCreate 函式 (acxelements.h)
AcxKeywordSpotterCreate 函式可用來建立與線路裝置物件父系相關聯的 ACX 關鍵詞 Spotter 物件。
語法
NTSTATUS AcxKeywordSpotterCreate(
ACXCIRCUIT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_KEYWORDSPOTTER_CONFIG Config,
ACXKEYWORDSPOTTER *KeywordSpotter
);
參數
Object
WDFDEVICE 物件 (將與線路相關聯的 Framework 物件 摘要) 中所述。
Attributes
使用 WDF_OBJECT_ATTRIBUTES 結構定義的其他屬性，可用來設定各種值，並將 KeywordSpotter 物件與父 WDF 裝置物件產生關聯。
Config
已初始化 ACX_KEYWORDSPOTTER_CONFIG結構 ，描述關鍵詞 spotter 的組態。
KeywordSpotter
接收新建立 ACXKEYWORDSPOTTER 物件句柄之位置的指標。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
範例
範例使用方式如下所示。
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);
ACX 需求
最小 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxelements.h |
| IRQL | PASSIVE_LEVEL |