Compartilhar via

Função AcxStreamAddConnections (acxstreams.h)

  • Artigo

A função AcxStreamAddConnections adiciona conexões explícitas a um novo fluxo ACX durante EvtAcxCircuitCreateStream

Sintaxe

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

Parâmetros

Stream

Um objeto de fluxo ACXSTREAM existente. Para obter mais informações, consulte ACX – Resumo de objetos ACX.

Connections

Uma estrutura ACX_CONNECTION que contém informações sobre as conexões para adicionar o fluxo.

ConnectionsCount

O número de conexões que estão no fluxo. Esta é uma contagem baseada em 1.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Se o driver não chamar AcxStreamAddConnections durante EvtAcxCircuitCreateStream, a estrutura ACX atribuirá automaticamente conexões entre quaisquer objetos ACXELEMENT que foram adicionados ao ACXSTREAM.

Exemplo

O uso de exemplo é mostrado abaixo.

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

Versão mínima do ACX: 1.0

Para obter mais informações sobre as versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxstreams.h
IRQL PASSIVE_LEVEL

Confira também