AcxStreamAddEvents 関数 (acxstreams.h)

  • [アーティクル]

AcxStreamAddEvents は、ACXEVENT オブジェクトを使用して既存のストリームにイベントを追加します。 ACX オブジェクトの詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。

構文

NTSTATUS AcxStreamAddEvents(
  ACXSTREAM Stream,
  ACXEVENT  *Events,
  ULONG     EventsCount
);

パラメーター

Stream

既存の ACXSTREAM オブジェクト。 ACXSTREAM オブジェクトは、回線によって作成されたオーディオ ストリームを表します。 ストリームは、親回線の要素に基づいて作成された要素の一覧で構成されます。

Events

Streamに追加する ACXEVENT オブジェクトへのポインター。 ACXEVENT オブジェクトは、ドライバー レベルで使用できる非同期通知を表します。 イベントは、AcxCircuits、AcxStreams、AcxElements、AcxPins に追加できます。 内部的には、上位レイヤーに KS イベントとして公開されます。 ACX オブジェクトの詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。

EventsCount

イベントの数。 これは 1 から始まるカウントです。

戻り値

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

解説

例

使用例を次に示します。

    ACXEVENT event;
    ...
    AcxStreamAddEvents(Stream, &event, 1);

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件 値
Header acxstreams.h
IRQL PASSIVE_LEVEL

こちらもご覧ください