AcxStreamAddConnections 関数 (acxstreams.h)

AcxStreamAddConnections 関数は、EvtAcxCircuitCreateStream 中に新しい ACX ストリームに明示的な接続を追加

構文

NTSTATUS AcxStreamAddConnections(
  ACXSTREAM       Stream,
  PACX_CONNECTION Connections,
  ULONG           ConnectionsCount
);

パラメーター

Stream

既存の ACXSTREAM ストリーム オブジェクト。 詳細については、ACX - ACX オブジェクトの概要を参照してください。

Connections

ストリームを追加する接続に関する情報を含む ACX_CONNECTION 構造体。

ConnectionsCount

ストリーム内にある接続の数。 これは 1 から始まるカウントです。

戻り値

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

備考

ドライバーが EvtAcxCircuitCreateStream 中に AcxStreamAddConnections を呼び出さない場合、ACX フレームワークは、ACXSTREAM に追加されたすべての ACXELEMENT オブジェクト間の接続を自動的に割り当てます。

例

使用例を次に示します。

    //
    // Explicitly connect the elements of the stream. Note that the driver doesn't 
    // need to perform this step when elements are connected in the same order
    // as they were added to the stream.
    //

    const int numElements = 2;
    const int numConnections = numElements + 1;

    ACXSTREAM                      Stream;

    ACX_CONNECTION connections[numConnections];
    ACX_CONNECTION_INIT(&connections[0], Stream, Elements[ElementCount - 2]);
    ACX_CONNECTION_INIT(&connections[1], Elements[ElementCount - 2], Elements[ElementCount - 1]);
    ACX_CONNECTION_INIT(&connections[2], Elements[ElementCount - 1], Stream);

    //
    // Add the connections linking stream to elements.
    //
    status = AcxStreamAddConnections(Stream, connections, SIZEOF_ARRAY(connections));

ACX の要件

最小 ACX バージョン: 1.0

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

必要条件

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

関連項目

• acxstreams.h ヘッダー を する