AcxPnpEventCreate 函数 (acxevents.h)
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 PNP 事件的配置 ACX_PNPEVENT_CONFIG 结构。
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 |