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

  • Статья

Функция 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

См. также раздел