Функция AcxCircuitInitAssignCategories (acxcircuit.h)
Функция 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 |