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 フレームワークによって使用され、回線の接続をオーディオ スタックに公開します。 Render 回線の場合、ソース ピンを使用して、回線から作成されたストリームのレンダリング動作 (デバイス プロパティ) を制御します。 キャプチャ回線では、シンク ピンを使用して、回線から作成されたストリームのキャプチャ動作 (デバイス プロパティ) を制御します。
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 バージョンの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |