通过

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE回调函数 （acxcircuit.h）

  • 项目

驱动程序使用 EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 回调在 ACX 管理器检测和初始化复合线路时执行任何初始化。

语法

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;

NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CircuitProperties
)
{...}

参数

Device

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

Circuit

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

CircuitProperties

CircuitProperties 的可选句柄。 这是 ACXCIRCUIT 属性的可选 ACXOBJECTBAG 对象。

返回值

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

言论

例

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

DspR_EvtCircuitCompositeCircuitInitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CircuitProperties
    )
{
    NTSTATUS status = STATUS_SUCCESS;

    PAGED_CODE();
    
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CircuitProperties != NULL)
    {
        DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
        ULONG testUI4;

        status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
        if (!NT_SUCCESS(status))
        {
            // Log error.
            goto exit;
        }

        //...
    }
    
    //...

    // All done.
    status = STATUS_SUCCESS;

exit:
    return status;
}

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求 价值
标头 acxcircuit.h
IRQL PASSIVE_LEVEL

另请参阅