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

こちらもご覧ください