AcxStreamBridgeCreate 関数 (acxstreams.h)
AcxStreamBridgeCreate 関数は、ACX_STREAM_BRIDGE_CONFIGを使用して回線の StreamBridge を作成します。
ACXSTREAMBRIDGE は、回線によって、ストリームの作成、ストリームの状態遷移、およびエンドポイントの回線ストリーム セグメント間の DRM 設定を伝達するために使用されます。 このオブジェクトは、マルチ回線 (オーディオ 複合) シナリオでのみ使用されます。
構文
NTSTATUS AcxStreamBridgeCreate(
ACXCIRCUIT AcxCircuit,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_STREAM_BRIDGE_CONFIG Config,
ACXSTREAMBRIDGE *StreamBridge
);
パラメーター
AcxCircuit
関連付けられた ACXCIRCUIT オブジェクトへのハンドルを受け取る場所へのポインター。 ACX オブジェクトの詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。
Attributes
さまざまなオブジェクトの値を設定するために使用される WDF_OBJECT_ATTRIBUTES を使用して定義された追加の属性:コールバック、コンテキスト型のクリーンアップと破棄、および親オブジェクトの指定。 詳細については、「 WDF_OBJECT_ATTRIBUTES 構造」およびこのトピックの「解説」セクションを参照してください。
Config
構成 を 定義するACX_STREAM_BRIDGE_CONFIG構造体。
StreamBridge
新しい ACXSTREAMBRIDGE オブジェクトへのハンドルを受け取る場所へのポインター。
戻り値
STATUS_SUCCESS呼び出しが成功した場合は を返します。 それ以外の場合は、適切なエラー コードを返します。 詳細については、「 NTSTATUS 値の使用」を参照してください。
注釈
オーディオ エンドポイントは、完全なオーディオ パスを作成するためにアセンブルされた 1 つ以上のオーディオ回線 (ACXCIRCUIT オブジェクト) のコレクションです。 ACX ドライバーは通常、異なるオーディオ エンドポイントのオーディオ回線を作成しますが、ACX は、同じドライバーによって作成された回線が異なるデバイス スタックに属している限り、同じオーディオ エンドポイントのコレクションに含まれることを禁止しません。 オーディオ エンドポイントは、同じまたは異なるオーディオ ドライバーによって作成されたオーディオ回線のコレクションです。
既定では、新しい ACXSTREAMBRIDGE オブジェクトの親は指定された ACXCIRCUIT です。 WDF_OBJECT_ATTRIBUTES構造体の ParentObject メンバーを使用して、ACXCIRCUIT を先祖として持つ別の親を指定できます。 フレームワークは、親オブジェクトを削除するときに ACXSTREAMBRIDGE オブジェクトを削除します。
ACXSTREAMBRIDGE オブジェクトの使用が完了すると、ドライバーは ACXSTREAMBRIDGE オブジェクトを削除できます。それ以外の場合、オブジェクトは親が削除されるまで保持されます。これは、ACXCIRCUIT の初期化/作成中に作成される場合です。
ピンは、0 個、1 つ以上の ACXSTREAMBRIDGEs に関連付けることができます。 ACX は、関連付けられている ACXPIN の信号処理モード リストでストリーム信号処理モードの一致を検索します。 検索は最初の一致で停止します。
ACX は、ACXCIRCUIT から ACXCIRCUIT ブリッジに対して既定の ACXSTREAMBRIDGE を作成します。ドライバーが作成せず、ドライバーが AcxCircuitInitDisableDefaultStreamBridgeHandling 関数を使用して既定のストリーム ブリッジ処理を無効にしなかった場合。
例
使用例を次に示します。
ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
ACXSTREAMBRIDGE bridge = NULL;
ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
bridgeCfg.InModesCount = 1;
bridgeCfg.InModes = inModes;
bridgeCfg.OutMode = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;
status = AcxStreamBridgeCreate(circuit, &attributes, &bridgeCfg, &bridge);
ACX の要件
最小 ACX バージョン: 1.0
ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| Header | acxstreams.h |
| IRQL | PASSIVE_LEVEL |