AcxDeviceAddFactoryCircuit, fonction (acxdevice.h)

  • Article

La fonction AcxDeviceAddFactoryCircuit ajoute un circuit d’usine à un WDFDEVICE pour créer des circuits audio.

Syntaxe

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Paramètres

Device

WDFDEVICE auquel le circuit d’usine ACX sera ajouté.

Factory

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

Valeur retournée

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

Remarques

Un pilote ACX peut créer un ou plusieurs circuits dans les scénarios suivants :

  • Au moment de l’initialisation
  • Au moment de l’exécution, comme effet secondaire d’un événement externe, comme la détection d’un nouveau composant audio
  • Parce qu’il s’est inscrit avec ACX comme fabrique de circuit. L’infrastructure ACX utilise l’usine inscrite pour demander au pilote de créer un nouveau circuit.

Utilisez AcxDeviceRemoveFactoryCircuit pour supprimer un circuit d’usine d’un WDFDEVICE.

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

Exemple

WDFDEVICE                Device;
NTSTATUS                 status;
PCAPTURE_DEVICE_CONTEXT  devCtx;

// Code to initialize WDFDEVICE...

//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);

if (!NT_SUCCESS(status))
{
    ASSERT(FALSE);
    goto exit;
}

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

Voir aussi