Condividi tramite

Funzione AcxStreamAddConnections (acxstreams.h)

  • Articolo

La funzione AcxStreamAddConnections aggiunge connessioni esplicite a un nuovo flusso ACX durante EvtAcxCircuitCreateStream

Sintassi

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

Parametri

Stream

Oggetto di flusso ACXSTREAM esistente. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.

Connections

Struttura ACX_CONNECTION che contiene informazioni sulle connessioni da aggiungere al flusso.

ConnectionsCount

Numero di connessioni presenti nel flusso. Si tratta di un conteggio basato su 1.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Se il driver non chiama AcxStreamAddConnections durante EvtAcxCircuitCreateStream, il framework ACX assegna automaticamente le connessioni tra gli oggetti ACXELEMENT aggiunti a ACXSTREAM.

Esempio

Di seguito è riportato l'esempio di utilizzo.

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

Requisiti ACX

Versione minima DI ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxstreams.h
IRQL PASSIVE_LEVEL

Vedi anche