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

Статья
02/06/2025

Функция AcxCircuitInitAssignCategories назначает набор записей KSCATERGORY для ACXCIRCUIT.

Синтаксис

NTSTATUS AcxCircuitInitAssignCategories(
  PACXCIRCUIT_INIT CircuitInit,
  const GUID       *Categories,
  ULONG            CategoriesCount
);

Параметры

CircuitInit

Структура ACXCIRCUIT_INIT, которая определяет инициализацию канала. ACXCIRCUIT_INIT — это непрозрачный объект, используемый для инициализации канала. Используйте AcxCircuitInitAllocate для инициализации структуры ACXCIRCUIT_INIT.

Categories

Массив, содержащий GUID требуемой KSCATERGORY, например KSCATEGORY_AUDIO. Дополнительные сведения о записях KSCATERGORY см. в установке интерфейсов устройств дляаудиоадаптера.

CategoriesCount

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

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

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

Замечания

Этот вызов переопределяет набор категорий по умолчанию, инициализированный ACX, основанный на типе ACXCIRCUIT.

Пример

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


    GUID captureCategories[] =
    {
        STATICGUIDOF(KSCATEGORY_AUDIO),
        STATICGUIDOF(KSCATEGORY_CAPTURE), 
        STATICGUIDOF(KSCATEGORY_REALTIME),
        STATICGUIDOF(KSCATEGORY_TOPOLOGY),
    };

    //
    // Add circuit identifiers.
    //
    AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

    status = AcxCircuitInitAssignCategories(CircuitInit, captureCategories, SIZEOF_ARRAY(captureCategories));

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

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

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

Требования

Требование	Ценность
заголовка	acxcircuit.h
IRQL	PASSIVE_LEVEL

См. также

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

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