Поделиться через

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

  • Статья

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

Синтаксис

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

Параметры

Circuit

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

Pins

Существующий объект ACXPIN, который будет добавлен в канал.

PinsCount

Количество контактов, которые будут добавлены в цепь. Это число на основе одного.

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

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

Комментарии

ACXCIRCUIT имеет по крайней мере входной контакт (ACXPIN) и выходной контакт (ACXPIN), и он может агрегировать один или несколько ACXELEMENT.

Каждый ACXCIRCUIT имеет по крайней мере один контакт приемника и один исходный контакт. Эти контакты используются платформой ACX для предоставления подключений канала к звуковому стеку. Для канала render контакт источника используется для управления поведением отрисовки (свойствами устройства) любого потока, созданного из канала. Для канала захвата контакт приемника используется для управления поведением захвата (свойствами устройства) любого потока, созданного из канала.

ACXPIN — это объект, используемый для управления потоковой передачей в звуковом пути. Для простых топологий ACXCIRCUIT ACX может автоматически создать другой ACXPIN, если присутствует только один.

Пример

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

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

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

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

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

Требования

Требование Значение
Заголовок acxcircuit.h
IRQL PASSIVE_LEVEL

См. также раздел