Funzione AcxCircuitAddPins (acxcircuit.h)
La funzione AcxCircuitAddPins aggiunge pin a un ACXCIRCUIT.
Sintassi
NTSTATUS AcxCircuitAddPins(
ACXCIRCUIT Circuit,
ACXPIN *Pins,
ULONG PinsCount
);
Parametri
Circuit
Oggetto ACXCIRCUIT esistente. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Pins
Oggetto ACXPIN esistente che verrà aggiunto al circuito.
PinsCount
Numero di pin 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
AcXCIRCUIT ha almeno un pin di input (ACXPIN) e un pin di output (ACXPIN) e può aggregare uno o più ACXELEMENTs.
Ogni ACXCIRCUIT ha almeno un pin sink e un pin di origine. Questi pin vengono usati dal framework ACX per esporre le connessioni del circuito allo stack audio. Per un circuito Di rendering, il pin di origine viene usato per controllare il comportamento di rendering (proprietà del dispositivo) di qualsiasi flusso creato dal circuito. Per un circuito Capture, il pin sink viene usato per controllare il comportamento di acquisizione (proprietà del dispositivo) di qualsiasi flusso creato dal circuito.
ACXPIN è l'oggetto usato per controllare lo streaming nel percorso audio. Per semplici topologie ACXCIRCUIT, ACX è in grado di creare automaticamente l'altro ACXPIN se presente solo uno.
Esempio
Di seguito è riportato l'esempio di utilizzo.
ACXPIN pin;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = circuit;
status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
// Add the supported formats to the Default mode for the circuit
//
formatList = AcxPinGetRawDataFormatList(pin[1]);
status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
//
// Add the default streaming pin, using default pin id.
//
status = AcxCircuitAddPins(circuit, &(pin[1]), 1);
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 |