AcxCircuitAddPins, fonction (acxcircuit.h)

  • Article

La fonction AcxCircuitAddPins ajoute des broches à un ACXCIRCUIT.

Syntaxe

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

Paramètres

Circuit

Objet ACXCIRCUIT existant. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

Pins

Objet ACXPIN existant qui sera ajouté au circuit.

PinsCount

Nombre de broches qui seront ajoutées au circuit. Il s’agit d’un nombre basé sur un seul.

Valeur retournée

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

Remarques

Un ACXCIRCUIT a au moins une broche d’entrée (ACXPIN) et une broche de sortie (ACXPIN), et il peut agréger un ou plusieurs ACXELEMENTs.

Chaque ACXCIRCUIT a au moins une broche Sink et une broche Source. Ces broches sont utilisées par l’infrastructure ACX pour exposer les connexions du circuit à la pile audio. Pour un circuit de rendu, la broche source est utilisée pour contrôler le comportement de rendu (propriétés de l’appareil) de tout flux créé à partir du circuit. Pour un circuit de capture, la broche récepteur est utilisée pour contrôler le comportement de capture (propriétés de l’appareil) de n’importe quel flux créé à partir du circuit.

ACXPIN est l’objet utilisé pour contrôler la diffusion en continu dans le chemin d’accès audio. Pour les topologies ACXCIRCUIT simples, ACX peut créer automatiquement l’autre ACXPIN si un seul est présent.

Exemple

L’exemple d’utilisation est illustré ci-dessous.

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

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 acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi