Partager via

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

Un 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 de retour

AcxDeviceAddFactoryCircuit retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle 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, en tant qu’effet secondaire d’un événement externe, par exemple la détection d’un nouveau composant audio
  • Parce qu’il s’est inscrit auprès d’ACX comme usine de circuit. L’infrastructure ACX utilise la fabrique 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 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