次の方法で共有

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 オブジェクトを削除できます。それ以外の場合、オブジェクトは親が削除されるまで保持されます。これは、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 バージョンの概要 参照してください。

必要条件

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

関連項目

  • acxstreams.h ヘッダー を する