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

Статья
02/06/2025

Функция 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. Внутренне AcxPnpEvents предоставляется как асинхронное уведомление 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

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