Función AcxStreamAddConnections (acxstreams.h)

La función AcxStreamAddConnections agrega conexiones explícitas a una nueva secuencia ACX durante EvtAcxCircuitCreateStream

Sintaxis

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

Parámetros

Stream

Objeto de secuencia ACXSTREAM existente. Para obtener más información, vea ACX : resumen de objetos ACX.

Connections

Estructura ACX_CONNECTION que contiene información sobre las conexiones para agregar la secuencia.

ConnectionsCount

Número de conexiones que se encuentran en la secuencia. Se trata de un recuento basado en 1.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Si el controlador no llama a AcxStreamAddConnections durante EvtAcxCircuitCreateStream, el marco de ACX asignará automáticamente conexiones entre los objetos ACXELEMENT que se agregaron a ACXSTREAM.

Ejemplo

A continuación se muestra un ejemplo de uso.

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

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxstreams.h
IRQL PASSIVE_LEVEL

Consulte también