AcxPnpEventCreate 函数 (acxevents.h)
AcxPnpEventCreate 函数创建 ACXPNPEVENT。
语法
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
参数
Device
与新事件关联的 框架对象) 摘要 中所述的现有 WDFDEVICE 对象 (。
Object
与事件关联的 ACX 对象摘要 中所述的现有 ACXAUDIOMODULE 对象。
Attributes
使用 WDF_OBJECT_ATTRIBUTES 定义的其他属性，用于设置各种对象的值：清理和销毁回调、上下文类型以及指定其父对象。
Config
定义 ACX PNP 事件的配置的 ACX_PNPEVENT_CONFIG 结构。
Event
ACXEVENT 对象 () 摘要 中所述。
返回值
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 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxevents.h |
| IRQL | PASSIVE_LEVEL |