AcxCircuitAddPins 関数 (acxcircuit.h)

AcxCircuitAddPins 関数は、ACXCIRCUIT にピンを追加します。

構文

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

パラメーター

Circuit

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

Pins

回線に追加される既存の ACXPIN オブジェクト。

PinsCount

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

戻り値

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

備考

ACXCIRCUIT には、少なくとも入力ピン (ACXPIN) と出力ピン (ACXPIN) があり、1 つ以上の ACXELEMENT を集約できます。

各 ACXCIRCUIT には、少なくとも 1 つのシンク ピンと 1 つのソース ピンがあります。 これらのピンは、ACX フレームワークによって、回線の接続をオーディオ スタックに公開するために使用されます。 レンダー回線の場合、ソース ピンは、回線から作成されたストリームのレンダリング動作 (デバイス プロパティ) を制御するために使用されます。 キャプチャ回線の場合、シンク ピンは、回線から作成されたストリームのキャプチャ動作 (デバイス プロパティ) を制御するために使用されます。

ACXPIN は、オーディオ パスのストリーミングを制御するために使用されるオブジェクトです。 単純な ACXCIRCUIT トポロジの場合、ACX は、1 つだけ存在する場合に他の ACXPIN を自動的に作成できます。

例

使用例を次に示します。

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

要件	価値
ヘッダー	acxcircuit.h
IRQL	PASSIVE_LEVEL

関連項目

• acxcircuit.h ヘッダー を する