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