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 |