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 標頭