通过

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE回调函数 （acxcircuit.h）

  • 项目

驱动程序使用 EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE 回调在 ACX 管理器组装复合终结点后执行任何后期初始化。

语法

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;

NTSTATUS EvtAcxCircuitCompositeInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

参数

Device

与指定的 ACXCIRCUIT 关联的 WDFDEVICE 对象（“框架对象摘要”中所述）。

Circuit

正在初始化的 ACXCIRCUIT 对象。 有关 ACX 对象的详细信息，请参阅 ACX 对象的摘要。

CompositeProperties

描述复合线路的 CompositeProperties 的可选句柄。 这是复合终结点属性的可选 ACXOBJECTBAG 对象。

返回值

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

言论

例

此示例代码演示如何驱动程序从指定的复合属性对象包中检索复合属性。

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;

NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
    _In_ WDFDEVICE      Device,
    _In_ ACXCIRCUIT     Circuit,
    _In_ ACXOBJECTBAG   CompositeProperties
    )
{
    PAGED_CODE();

    NTSTATUS status = STATUS_SUCCESS;

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    ASSERT(CompositeProperties);

    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    GUID uniqueId = {0};
    status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);

    // ...

    return status;
}

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求 价值
标头 acxcircuit.h
IRQL PASSIVE_LEVEL

另请参阅