Partager via

AcxDeviceRemoveFactoryCircuit, fonction (acxdevice.h)

  • Article

La fonction AcxDeviceRemoveFactoryCircuit supprime un circuit d’usine pour la création de circuits audio d’un WDFDEVICE.

Syntaxe

NTSTATUS AcxDeviceRemoveFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Paramètres

Device

Le WDFDEVICE duquel le circuit d’usine ACX sera supprimé.

Factory

Circuit d’usine ACX à supprimer du WDFDEVICE spécifié par le paramètre Device.

Valeur de retour

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

Remarques

Un pilote classique n’a pas besoin d’appeler AcxDeviceRemoveFactoryCircuit. Cette fonction ne doit pas être appelée si le circuit d’usine a créé des périphériques de circuit qui sont toujours actifs.

Si un pilote décide d’appeler cette fonction pour un circuit d’usine, le pilote devient responsable de la première suppression des périphériques de circuit créés via le circuit d’usine associé, avantAcxDeviceRemoveFactoryCircuit est appelé.

Pour plus d’informations sur l’utilisation des circuits, consultez suppression dynamique des circuits ACX et énumération d’appareils ACX.

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

Utilisez AcxDeviceAddFactoryCircuit pour ajouter un circuit d’usine à unWDFDEVICE .

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