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

関連項目

• acxcircuit.h ヘッダー を する