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 バージョンの概要」を参照してください。

要件

要件	値
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxcircuit.h ヘッダー