AcxFactoryCircuitInitAssignCategories 函数 (acxcircuit.h)

AcxFactoryCircuitInitAssignCategories 函数为 ACXFACTORYCIRCUIT 分配一组驱动程序类别 (GUID) 条目。

语法

NTSTATUS AcxFactoryCircuitInitAssignCategories(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  const GUID              *Categories,
  ULONG                   CategoriesCount
);

参数

FactoryInit

用于线路工厂初始化的ACXFACTORYCIRCUIT_INIT结构。 这是一种不透明结构，用于存储 ACX 线路工厂初始化信息并将工厂与 WDF 设备相关联。

使用 AcxFactoryCircuitInitAllocate 函数 初始化 ACXFACTORYCIRCUIT_INIT 结构。

Categories

一个数组，其中包含所需驱动程序类别条目集的 GUID。 有关 KSCATERGORY 条目的详细信息，请参阅 安装音频适配器的设备接口。

CategoriesCount

将添加到线路的类别数。 这是一个基于 1 的计数。

返回值

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 标头