Функция AcxFactoryCircuitInitAssignCategories (acxcircuit.h)
Функция AcxFactoryCircuitInitAssignCategories назначает набор записей категории драйверов (GUID) для ACXFACTORYCIRCUIT.
Синтаксис
NTSTATUS AcxFactoryCircuitInitAssignCategories(
PACXFACTORYCIRCUIT_INIT FactoryInit,
const GUID *Categories,
ULONG CategoriesCount
);
Параметры
FactoryInit
Структура ACXFACTORYCIRCUIT_INIT, используемая для инициализации фабрики цепи. Это непрозрачная структура, которая используется для хранения сведений об инициализации фабрики цепи ACX и связывания фабрики с устройством WDF.
Используйте функцию AcxFactoryCircuitInitAllocate для инициализации структуры ACXFACTORYCIRCUIT_INIT.
Categories
Массив, содержащий идентификаторы GUID нужного набора записей категории драйверов. Дополнительные сведения о записях KSCATERGORY см. в разделе Установка интерфейсов устройств для аудиоадаптера.
CategoriesCount
Количество категорий, которые будут добавлены в цепь. Это число на основе одного.
Возвращаемое значение
Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.
Комментарии
Этот вызов переопределяет набор категорий по умолчанию, инициализированный ACX.
Пример
Ниже приведен пример использования.
ACXFACTORYCIRCUIT factory;
PACXFACTORYCIRCUIT_INIT factoryInit = NULL;
SDCAXU_FACTORYCIRCUIT_CONTEXT * factoryCtx;
ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS operationCallbacks;
//
// Get a FactoryCircuitInit structure.
//
factoryInit = AcxFactoryCircuitInitAllocate(Device);
//
// Add factory identifiers.
//
AcxFactoryCircuitInitSetComponentId(factoryInit, &SDCAXU_FACTORY_GUID);
AcxFactoryCircuitInitAssignCategories(factoryInit, &SDCAXU_FACTORY_CATEGORY, 1);
Требования к ACX
Минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.
Требования
| Требование | Значение |
|---|---|
| Заголовок | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |