AcxDeviceRemoveCircuit, fonction (acxdevice.h)

Article
02/06/2025

La fonction AcxDeviceRemoveCircuit supprime le circuit audio spécifié d’un appareil ACX.

Syntaxe

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Paramètres

Device

Le WDFDEVICE duquel supprimer le circuit audio spécifié par le paramètre Circuit.

Circuit

Circuit audio à supprimer du WDFDEVICE spécifié par le paramètre Device.

Valeur de retour

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

Remarques

Utilisez AcxDeviceAddCircuit pour ajouter un circuit audio à un WDFDEVICE.

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

Exemple

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

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