Поделиться через

Функция AcxKeywordSpotterCreate (acxelements.h)

  • Статья

Функция AcxKeywordSpotterCreate используется для создания объекта ACX ключевое слово точечных устройств, который будет связан с родительским объектом устройства цепи.

Синтаксис

NTSTATUS AcxKeywordSpotterCreate(
  ACXCIRCUIT                 Object,
  PWDF_OBJECT_ATTRIBUTES     Attributes,
  PACX_KEYWORDSPOTTER_CONFIG Config,
  ACXKEYWORDSPOTTER          *KeywordSpotter
);

Параметры

Object

Объект WDFDEVICE ( описанный в разделе Сводка объектов платформы), который будет связан с каналом.

Attributes

Дополнительные атрибуты, определенные с помощью структуры WDF_OBJECT_ATTRIBUTES , которые используются для задания различных значений и для связывания объекта KeywordSpotter с родительским объектом устройства WDF.

Config

Инициализированная структура ACX_KEYWORDSPOTTER_CONFIG, описывающая конфигурацию ключевое слово споттера.

KeywordSpotter

Указатель на расположение, которое получает дескриптор созданного объекта ACXKEYWORDSPOTTER. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

Возвращаемое значение

Возвращает значение STATUS_SUCCESS , если вызов был успешным. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.

Remarks

Пример

Ниже приведен пример использования.

    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

См. также раздел