AcxCircuitAddElements 関数 (acxcircuit.h)

AcxCircuitAddElements 関数は、ACXCIRCUIT に要素を追加します。

構文

NTSTATUS AcxCircuitAddElements(
  ACXCIRCUIT Circuit,
  ACXELEMENT *Elements,
  ULONG      ElementsCount
);

パラメーター

Circuit

既存の ACXCIRCUIT オブジェクト。 ACX オブジェクトの詳細については、「 ACX オブジェクトの概要」を参照してください。

Elements

回線に追加される 1 つ以上の ACXELEMENT オブジェクト。

ElementsCount

回路に追加される要素の数。 これは 1 から始まるカウントです。

戻り値

STATUS_SUCCESS呼び出しが成功した場合は を返します。 それ以外の場合は、適切なエラー コードを返します。 詳細については、「 NTSTATUS 値の使用」を参照してください。

注釈

ドライバーは、回路がデバイスに追加される前にのみ、回路に要素を追加できます。 ドライバーは、実行時に回線の要素を変更できません。

例

使用例を次に示します。

    //
    // Add a second element.
    //
    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
    attributes.ParentObject = circuit;
    
    status = AcxElementCreate(circuit, &attributes, &elementCfg, &elements[1]);

    //
    // Add the elements to the circuit.
    //
    status = AcxCircuitAddElements(circuit, elements, SIZEOF_ARRAY(elements));

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。

要件

要件	値
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxcircuit.h ヘッダー