Funzione AcxDeviceAddCircuit (acxdevice.h)
La funzione AcxDeviceAddCircuit aggiunge un circuito ACX a un WDFDEVICE per creare un endpoint audio.
Sintassi
NTSTATUS AcxDeviceAddCircuit(
WDFDEVICE Device,
ACXCIRCUIT Circuit
);
Parametri
Device
Un WDFDEVICE che rappresenta il dispositivo a cui verrà aggiunto il circuito.
Circuit
Circuito da aggiungere al dispositivo .
Valore restituito
AcxDeviceAddCircuit restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un NTSTATUS codice di errore.
Osservazioni
Il circuito audio è il blocco predefinito principale di ACX. Un driver audio crea uno o più oggetti circuito ACX per rappresentare un percorso di controllo e dati audio parziale o completo. ACX assembla questi oggetti circuito ACX insieme per creare un percorso audio completo che rappresenta un endpoint audio.
Questa funzione può essere chiamata solo dalla funzione di callback EVT_WDF_DEVICE_PREPARE_HARDWARE per questo dispositivo.
Esempio
WDFDEVICE Device;
NTSTATUS status;
PCODEC_DEVICE_CONTEXT devCtx;
// Code to initialize the WDFDEVICE...
devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);
//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);
if (!NT_SUCCESS(status))
{
ASSERT(FALSE);
goto exit;
}
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxdevice.h |
| IRQL | PASSIVE_LEVEL |