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

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

См. также