AcxDeviceDetachCircuit, fonction (acxdevice.h)

Article
02/06/2025

La fonction AcxDeviceDetachCircuit détache un circuit audio d’un WDFDEVICE avant la suppression.

Syntaxe

NTSTATUS AcxDeviceDetachCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Paramètres

Device

Le WDFDEVICE à partir duquel détacher 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

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

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

AcxDeviceDetachCircuit détache le circuit de l’appareil. L’appelant est chargé de supprimer l’objet ACXCIRCUIT.

Remarques

Exemple

WDFDEVICE                    Device;
NTSTATUS                     status;
PCODEC_RENDER_DEVICE_CONTEXT renderDevCtx = NULL;

// Code to initialize WDFDEVICE...

renderDevCtx = GetRenderDeviceContext(Device);

ASSERT(renderDevCtx->Circuit);
status = AcxDeviceDetachCircuit(Device, renderDevCtx->Circuit);

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