AcxDeviceAddCircuit, fonction (acxdevice.h)

Article
02/22/2024

La fonction AcxDeviceAddCircuit ajoute un circuit ACX à un WDFDEVICE pour créer un point de terminaison audio.

Syntaxe

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Paramètres

Device

WDFDEVICE représentant l’appareil auquel le circuit sera ajouté.

Circuit

Circuit à ajouter à l’appareil.

Valeur retournée

AcxDeviceAddCircuit retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur NTSTATUS .

Remarques

Le circuit audio est le bloc de construction principal d’ACX. Un pilote audio crée un ou plusieurs objets de circuit ACX pour représenter un chemin de contrôle et de données audio partiels ou complets. ACX assemble ces objets de circuit ACX pour créer un chemin audio complet qui représente un point de terminaison audio.

Cette fonction ne peut être appelée qu’à partir de la fonction de rappel EVT_WDF_DEVICE_PREPARE_HARDWARE pour cet appareil.

Exemple

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;
}

Configuration requise d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise	Valeur
En-tête	acxdevice.h
IRQL	PASSIVE_LEVEL

Partager via