Share via

Función AcxCircuitAddElements (acxcircuit.h)

  • Artículo

La función AcxCircuitAddElements agrega elementos a un ACXCIRCUIT.

Sintaxis

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

Parámetros

Circuit

Objeto ACXCIRCUIT existente. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

Elements

Uno o varios objetos ACXELEMENT que se agregarán al circuito.

ElementsCount

Número de elementos que se agregarán al circuito. Se trata de un recuento basado.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

El controlador solo puede agregar elementos a un circuito antes de que el circuito se agregue al dispositivo. El controlador no puede cambiar los elementos del circuito en tiempo de ejecución.

Ejemplo

A continuación se muestra un ejemplo de uso.


    //
    // 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));

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Consulte también