Partager via


AcxDeviceRemoveCircuitDevice, fonction (acxdevice.h)

La fonction AcxDeviceRemoveCircuitDevice supprime un périphérique de circuit ACX d’un appareil parent spécifié.

Syntaxe

NTSTATUS AcxDeviceRemoveCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Paramètres

ParentDevice

Le parent WDFDEVICE duquel supprimer l’appareil de circuit ACX.

Device

Le WDFDEVICE représentant l’appareil de circuit à supprimer de l’appareil parent.

Valeur de retour

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

Remarques

Les pilotes audio utilisent cette fonction pour supprimer un point de terminaison audio existant.

Cette fonction peut être appelée à tout moment pendant le cycle de vie du pilote. Plug-and-Play s’occupe de sérialiser la suppression de l’appareil et les circuits associés, par rapport à d’autres activités Plug-and-Play sur les appareils parents et frères.

Exemple

NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;

// Code to initialize WDFDEVICE objects...

// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);

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

Voir aussi