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 |