Функция AcxPnpEventCreate (acxevents.h)

Статья
10/05/2023

Функция AcxPnpEventCreate создает ACXPNPEVENT.

Синтаксис

NTSTATUS AcxPnpEventCreate(
  WDFDEVICE              Device,
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_PNPEVENT_CONFIG   Config,
  ACXPNPEVENT            *Event
);

Параметры

Device

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

Object

Существующий объект ACXAUDIOMODULE, описанный в разделе Сводка по объектам ACX , которые будут связаны с событием.

Attributes

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

Config

Структура ACX_PNPEVENT_CONFIG , которая определяет конфигурацию события ACX PNP.

Event

Объект ACXEVENT (описан в разделе Сводка по объектам ACX).

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

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

ACXPNPEVENT представляет асинхронное уведомление, доступное на уровне драйвера. События PNP можно добавлять в любые объекты. В настоящее время они используются с объектами ACXAUDIOMODULE и ACXKEYWARDSPOTTER. Внутренние события AcxPnpEvent предоставляются в виде асинхронного уведомления PNP для верхних слоев.

Пример

В этом примере кода показано использование AcxPnpEventCreate.

    NTSTATUS                        status;
    ACXAUDIOMODULE                  audioModuleElement;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACX_PNPEVENT_CONFIG             audioModuleEventCfg;
    ACXPNPEVENT                     audioModuleEvent;

    ...

    status = AcxAudioModuleCreate(Circuit, &attributes, &audioModuleCfg, &audioModuleElement);
    audioModule0Ctx = GetCodecAudioModule0Context(audioModuleElement);

    ACX_PNPEVENT_CONFIG_INIT(&audioModuleEventCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_PNPEVENT_CONTEXT);
    attributes.ParentObject = audioModuleElement;
    status = AcxPnpEventCreate(Device, audioModuleElement, &attributes, &audioModuleEventCfg, &audioModuleEvent);

Требования к ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование	Значение
Заголовок	acxevents.h
IRQL	PASSIVE_LEVEL

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

Заголовок acxevents.h