AcxDeviceRemoveCircuit, fonction (acxdevice.h)

Article
02/22/2024

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

Syntaxe

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Paramètres

Device

WDFDEVICE à partir 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 retournée

AcxDeviceRemoveCircuit retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il 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 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