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

  • Статья

Функция AcxPnpEventGenerateEvent создает событие ACX PNP.

Синтаксис

NTSTATUS AcxPnpEventGenerateEvent(
  ACXPNPEVENT Event,
  PVOID       Payload,
  USHORT      Size
);

Параметры

Event

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

Payload

Полезные данные события.

Size

Размер полезных данных события.

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

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

Комментарии

Полезные данные зависят от типа создаваемого события PNP.

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

Пример

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

        AUDIOMODULE_CUSTOM_NOTIFICATION customNotification = {0};

        customNotification.Type = AudioModuleParameterChanged;
        customNotification.ParameterChanged.ParameterId = command->ParameterId;

        status = AcxPnpEventGenerateEvent(audioModuleCtx->Event, &customNotification, (USHORT)sizeof(customNotification));

Требования ACX

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

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

Требования

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

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