共用方式為

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE回呼函式 （acxcircuit.h）

  • 發行項

驅動程式會使用 EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE 回呼，在 ACX Manager 偵測並初始化複合線路時執行任何初始化。

語法

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;

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

參數

Device

與指定 ACXCIRCUIT 相關聯的 WDFDEVICE 物件（如 Framework 物件的摘要中所述。

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

另請參閱