AcxDeviceAddCircuit, fonction (acxdevice.h)

Article
02/06/2025

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

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

Circuit

Circuit à ajouter au de l’appareil.

Valeur de retour

AcxDeviceAddCircuit retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle 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 d’accès audio partiel ou complet. ACX assemble ces objets de circuit ACX ensemble 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 pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence	Valeur
d’en-tête	acxdevice.h
IRQL	PASSIVE_LEVEL

Partager via