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

Функция 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), и он может агрегировать один или несколько ACXELEMENTs.

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

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

См. также