Condividi tramite

Funzione AcxDeviceAddCircuit (acxdevice.h)

  • Articolo

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 codice di errore NTSTATUS .

Commenti

Il circuito audio è il blocco predefinito principale di ACX. Un driver audio crea uno o più oggetti circuito ACX per rappresentare un percorso 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 ACX, vedere Panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxdevice.h
IRQL PASSIVE_LEVEL

Vedi anche