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

另請參閱