通过

AcxEventCreate 函数 (acxevents.h)

  • 项目

AcxEventCreate 函数创建 ACX 事件。

语法

NTSTATUS AcxEventCreate(
  ACXOBJECT              Object,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_EVENT_CONFIG      Config,
  ACXEVENT               *Event
);

参数

Object

ACX 对象摘要中所述的 ACXOBJECT。

Attributes

使用 WDF_OBJECT_ATTRIBUTES 定义的其他属性，这些属性用于设置各种对象的值：清理和销毁回调、上下文类型以及指定其父对象。

Config

定义 ACX 事件配置的 ACX_EVENT_CONFIG 结构。

Event

新创建的 ACXEVENT 对象 () 的 ACX 对象摘要 中所述。

返回值

STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。

注解

ACXEVENT 表示驱动程序级别可用的异步通知。 可以将事件添加到 ACXCIRCUIT、ACXSTREAMs、ACXELEMENTs 和 ACXPIN。 在内部，它们作为 KS 事件公开到上层。 有关 KS 事件的详细信息，请参阅 KS 事件。

示例

此示例代码截图显示 ACX 如何使用 AcxEventCreate 创建音频插孔更改事件。

    NTSTATUS status = STATUS_SUCCESS;
    
    PAGED_CODE();

    ACX_EVENT_CALLBACKS         eventCallbacks;
    ACX_EVENT_CONFIG            eventCfg;
    AFX_PIN_EVENT_CONTEXT       *eventCtx;
    ACXEVENT                    jackEvent;
    WDF_OBJECT_ATTRIBUTES       attributes;

    //
    // Add jack info change event to this jack object
    //
    ACX_EVENT_CALLBACKS_INIT(&eventCallbacks);
    eventCallbacks.EvtAcxEventEnable = &AfxPin::EvtJackEventEnableCallback;
    eventCallbacks.EvtAcxEventDisable = &AfxPin::EvtJackEventDisableCallback;

    ACX_EVENT_CONFIG_INIT(&eventCfg);
    eventCfg.Set = &KSEVENTSETID_PinCapsChange;
    eventCfg.Id = KSEVENT_PINCAPS_JACKINFOCHANGE;
    eventCfg.Callbacks = &eventCallbacks;

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, AFX_PIN_EVENT_CONTEXT);
    attributes.ParentObject = GetObjectHandle();
    status = AcxEventCreate(GetObjectHandle(), &attributes, &eventCfg, &jackEvent);

ACX 要求

最低 ACX 版本： 1.0

有关 ACX 版本的详细信息，请参阅 ACX 版本概述。

要求

要求 值
Header acxevents.h
IRQL PASSIVE_LEVEL

另请参阅