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

추가 정보