AcxRtStreamCreate 関数 (acxstreams.h)

  • [アーティクル]

AcxRtStreamCreate は、OS がオーディオ データをストリーミングするために使用する ACX RTStream オーディオ ストリームを作成します。

構文

NTSTATUS AcxRtStreamCreate(
  WDFDEVICE              Device,
  ACXCIRCUIT             Circuit,
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACXSTREAM_INIT        *Config,
  ACXSTREAM              *Stream
);

パラメーター

Device

指定した ACXCIRCUIT とそのストリームに関連付けられている WDFDEVICE オブジェクト (「フレームワーク オブジェクトの概要」で説明)。

Circuit

このストリームが関連付けられる ACXCIRCUIT。

Attributes

さまざまなオブジェクトの値を設定するために使用される WDF_OBJECT_ATTRIBUTES を使用して定義された追加の属性: コールバックのクリーンアップと破棄、コンテキストの種類、および親オブジェクトの指定。

Config

ストリームの初期化パラメーターを定義するACXSTREAM_INIT構造体。 ACX オブジェクトの詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。

Stream

新しい ACXSTREAM オブジェクトへのハンドルを受け取る場所へのポインター。

ACXSTREAM オブジェクトは、回線によって作成されたオーディオ ストリームを表します。 詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。

戻り値

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

注釈

ACXSTREAM が作成されると、ドライバーは 1 つ以上の ACX 要素をストリームに追加できます。 既定では、ACX 要素はアセンブリの同じ順序で接続されます。 ACXSTREAM は、1 つの ACXCIRCUIT にのみ関連付けられます。 ACX では、非ストリーミング回線で使用される基本的な ACX ストリーム オブジェクトと、ストリーミング回線で使用される ACX RealTime (RT) ストリーム オブジェクトの 2 種類のストリームがサポートされています。

AcxRtStreamCreate によって作成された ACXSTREAM を使用すると、ドライバーはストリームに関連付けられているコントロール シグナルと状態の変更を受信できます。 ACXSTREAM は、OS 間でのオーディオ データのストリーミングもサポートします。 オーディオ データのストリーミングをサポートするドライバーでは、AcxRtStreamCreate を使用して、ストリーミングをサポートする ACXSTREAM を作成する必要があります。

複数のドライバー間で複数の ACXCIRCUIT から作成されたエンドポイントの場合、ストリーミング ピンをホストする ACXCIRCUIT は ACX RT Streamを作成し、エンドポイント内の他の ACXCIRCUIT は RT 以外の ACX ストリームを作成します。

例

Rt ストリームの作成例を次に示します。

    //
    // Init streaming callbacks.
    //
    ACX_STREAM_CALLBACKS streamCallbacks;
    ACX_STREAM_CALLBACKS_INIT(&streamCallbacks);
    streamCallbacks.EvtAcxStreamPrepareHardware     = EvtStreamPrepareHardware;
    streamCallbacks.EvtAcxStreamReleaseHardware     = EvtStreamReleaseHardware;
    streamCallbacks.EvtAcxStreamRun                 = EvtStreamRun;
    streamCallbacks.EvtAcxStreamPause               = EvtStreamPause;
    streamCallbacks.EvtAcxStreamAssignDrmContentId  = EvtStreamAssignDrmContentId;

    status = AcxStreamInitAssignAcxStreamCallbacks(StreamInit, &streamCallbacks);

    //
    // Init RT Streaming callbacks.
    //
    ACX_RT_STREAM_CALLBACKS rtCallbacks;
    ACX_RT_STREAM_CALLBACKS_INIT(&rtCallbacks);
    rtCallbacks.EvtAcxStreamGetHwLatency = EvtStreamGetHwLatency;
    rtCallbacks.EvtAcxStreamAllocateRtPackets = EvtStreamAllocateRtPackets;
    rtCallbacks.EvtAcxStreamFreeRtPackets = EvtStreamFreeRtPackets;
    rtCallbacks.EvtAcxStreamSetRenderPacket = EvtStreamSetRenderPacket;
    rtCallbacks.EvtAcxStreamGetCurrentPacket = EvtStreamGetCurrentPacket;
    rtCallbacks.EvtAcxStreamGetPresentationPosition = EvtStreamGetPresentationPosition;

    status = AcxStreamInitAssignAcxRtStreamCallbacks(StreamInit, &rtCallbacks);

    //
    // Create the stream.
    //
    WDF_OBJECT_ATTRIBUTES attributes;
    ACXSTREAM stream;
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, STREAM_CONTEXT);
    attributes.EvtCleanupCallback = EvtStreamContextCleanup;
    attributes.EvtDestroyCallback = EvtStreamDestroy;
    status = AcxRtStreamCreate(Device, Circuit, &attributes, &StreamInit, &stream);

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxstreams.h
IRQL PASSIVE_LEVEL

こちらもご覧ください