Funzione AcxStreamAddConnections (acxstreams.h)
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 |