Compartir a través de


Función AcxCircuitAddElements (acxcircuit.h)

La función AcxCircuitAddElements agrega elementos a 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 Using NTSTATUS Values.

Observaciones

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

Ejemplo

A continuación se muestra el uso de ejemplo.


    //
    // 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
encabezado de acxcircuit.h
irQL PASSIVE_LEVEL

Consulte también