AcxKeywordSpotterCreate 函数 (acxelements.h)
AcxKeywordSpotterCreate 函数用于创建将与线路设备对象父项关联的 ACX 关键字 (keyword) spotter 对象。
语法
NTSTATUS AcxKeywordSpotterCreate(
ACXCIRCUIT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_KEYWORDSPOTTER_CONFIG Config,
ACXKEYWORDSPOTTER *KeywordSpotter
);
参数
Object
(将与线路关联的 框架对象) 摘要中所述的 WDFDEVICE 对象。
Attributes
使用 WDF_OBJECT_ATTRIBUTES 结构定义的其他属性，该结构用于设置各种值并将 KeywordSpotter 对象与父 WDF 设备对象相关联。
Config
描述关键字 (keyword) 点的配置的初始化ACX_KEYWORDSPOTTER_CONFIG结构。
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 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxelements.h |
| IRQL | PASSIVE_LEVEL |