AcxCircuitAddElements, fonction (acxcircuit.h)

La fonction AcxCircuitAddElements ajoute des éléments à un ACXCIRCUIT.

Syntaxe

NTSTATUS AcxCircuitAddElements(
  ACXCIRCUIT Circuit,
  ACXELEMENT *Elements,
  ULONG      ElementsCount
);

Paramètres

Circuit

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

Elements

Un ou plusieurs objets ACXELEMENT qui seront ajoutés au circuit.

ElementsCount

Nombre d’éléments qui seront ajoutés 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

Le pilote peut uniquement ajouter des éléments à un circuit avant que le circuit ne soit ajouté à l’appareil. Le pilote ne peut pas modifier les éléments du circuit au moment de l’exécution.

Exemple

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

    //
    // Add a second element.
    //
    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_ELEMENT_CONTEXT);
    attributes.ParentObject = circuit;
    
    status = AcxElementCreate(circuit, &attributes, &elementCfg, &elements[1]);

    //
    // Add the elements to the circuit.
    //
    status = AcxCircuitAddElements(circuit, elements, SIZEOF_ARRAY(elements));

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

Voir aussi

• en-tête acxcircuit.h