Функция AcxStreamAddConnections (acxstreams.h)

Статья
02/06/2025

Функция acxStreamAddConnections добавляет явные подключения к новому потоку ACX во время EvtAcxCircuitCreateStream

Синтаксис

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

Параметры

Stream

Существующий объект потока ACXSTREAM. Дополнительные сведения см. в разделе ACX — сводка по объектам ACX.

Connections

Структура ACX_CONNECTION, содержащая сведения о подключениях для добавления потока.

ConnectionsCount

Количество подключений, которые находятся в потоке. Это число на основе 1.

Возвращаемое значение

Возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в использовании значений NTSTATUS.

Замечания

Если драйвер не вызывает AcxStreamAddConnections во время EvtAcxCircuitCreateStream, платформа ACX автоматически назначает подключения между любыми объектами ACXELEMENT, добавленными в ACXSTREAM.

Пример

Ниже показан пример использования.

    //
    // 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

Поделиться через