AcxCircuitAddPins, fonction (acxcircuit.h)
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.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
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 récepteur 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) d’un 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) d’un flux créé à partir du circuit.
ACXPIN est l’objet utilisé pour contrôler la diffusion en continu dans le chemin audio. Pour les topologies ACXCIRCUIT simples, ACX est en mesure de 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 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 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |