acxPnpEventCreate 函式 (acxevents.h)
AcxPnpEventCreate 函式會建立 ACXPNPEVENT。
語法
NTSTATUS AcxPnpEventCreate(
WDFDEVICE Device,
ACXOBJECT Object,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_PNPEVENT_CONFIG Config,
ACXPNPEVENT *Event
);
參數
Device
現有的 WDFDEVICE 物件 (描述於與新事件相關聯的 Framework 物件摘要) 。
Object
現有的 ACXAUDIOMODULE 物件，如與事件相關聯的 ACX 物件摘要 中所述。
Attributes
使用用來設定各種物件值 之WDF_OBJECT_ATTRIBUTES 定義的其他屬性：清除和終結回呼、內容類型，以及指定其父物件。
Config
定義 ACX PNP 事件組態 的ACX_PNPEVENT_CONFIG 結構。
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 |