Partager via


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.

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

Le pilote peut uniquement ajouter des éléments à un circuit avant l’ajout du circuit à 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 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

Voir aussi