Функция AcxCircuitAddElements (acxcircuit.h)

Функция AcxCircuitAddElements добавляет элементы в ACXCIRCUIT.

Синтаксис

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

Параметры

Circuit

Существующий объект ACXCIRCUIT. Дополнительные сведения о объектах ACX см. в сводке по объектам ACX.

Elements

Один или несколько объектов ACXELEMENT, которые будут добавлены в канал.

ElementsCount

Количество элементов, которые будут добавлены в канал. Это одно число на основе.

Возвращаемое значение

Возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в использовании значений NTSTATUS.

Замечания

Драйвер может добавлять элементы только в канал перед добавлением канала на устройство. Драйвер не может изменять элементы канала во время выполнения.

Пример

Ниже показан пример использования.

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

Требования к ACX

минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в обзоре версий ACX.

Требования

См. также

• заголовка acxcircuit.h