EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE fonction de rappel (acxcircuit.h)

  • Article

Le rappel EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE est appelé par ACX lorsque le pilote doit supprimer un WDFDEVICE créé précédemment associé à un objet ACXCIRCUIT.

Syntaxe

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

Paramètres

Parent

Objet WDFDEVICE (décrit dans Summary of Framework Objects) qui est le parent du WDFDEVICE référencé dans l’objet Device.

Factory

Objet ACXFACTORYCIRCUIT de la fabrique de circuits existante. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Device

Objet WDFDEVICE (décrit dans Résumé des objets framework) qui doit être supprimé.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Remarques

Un AcxFactoryCircuit représente un objet de fabrique capable de créer un ACXCIRCUIT à la demande.

Un pilote peut inscrire un ou plusieurs ACXFACTORYCIRCUIT auprès d’ACX. Cette action permet à ACX de savoir que le pilote est capable de créer des ACXCIRCUITs d’un type bien défini.

ACX appelle les rappels d’ACXFACTORYCIRCUIT lorsqu’il détecte qu’un chemin audio nécessite l’un des ACXCIRCUIT fournis par la fabrique.

Il s’agit d’un rappel facultatif. Si le rappel EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE n’est pas défini, ACX prend l’action par défaut de supprimer le WDFDEVICE spécifié de la liste des appareils énumérés. Cette action déclenche une notification PnP supprimée par surprise à l’enfant WDFDEVICE.

L’objet ACXFACTORYCIRCUIT prend en charge les ACXCIRCUIT dynamiques, ce qui signifie que chaque ACXCIRCUIT créé par la fabrique est associé à un objet WDFDEVICE et que ces deux objets ont la même durée de vie.

Un AcxFactoryCircuit a une file d’attente WDF dédiée. Pour plus d’informations sur les files d’attente WDF, consultez Framework Queue Objects.

Configuration requise pour ACX

Version ACX minimale : 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 acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi