Функция 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

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