Funzione AcxCircuitAddElements (acxcircuit.h)
La funzione AcxCircuitAddElements aggiunge elementi a un ACXCIRCUIT.
Sintassi
NTSTATUS AcxCircuitAddElements(
ACXCIRCUIT Circuit,
ACXELEMENT *Elements,
ULONG ElementsCount
);
Parametri
Circuit
Oggetto ACXCIRCUIT esistente. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Elements
Uno o più oggetti ACXELEMENT che verranno aggiunti al circuito.
ElementsCount
Numero di elementi che verranno aggiunti al circuito. Si tratta di un conteggio basato.
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
Il driver può aggiungere solo elementi a un circuito prima che il circuito venga aggiunto al dispositivo. Il driver non può modificare gli elementi del circuito in fase di esecuzione.
Esempio
Di seguito è riportato l'esempio di utilizzo.
//
// Add a second element.
//
ACX_ELEMENT_CONFIG_INIT(&elementCfg);
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
attributes.ParentObject = circuit;
status = AcxElementCreate(circuit, &attributes, &elementCfg, &elements[1]);
//
// Add the elements to the circuit.
//
status = AcxCircuitAddElements(circuit, elements, SIZEOF_ARRAY(elements));
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |