AcxCircuitInitAssignCategories 函数 (acxcircuit.h)

AcxCircuitInitAssignCategories 函数为 ACXCIRCUIT 分配一组 KSCATERGORY 条目。

语法

NTSTATUS AcxCircuitInitAssignCategories(
  PACXCIRCUIT_INIT CircuitInit,
  const GUID       *Categories,
  ULONG            CategoriesCount
);

参数

CircuitInit

定义线路初始化的ACXCIRCUIT_INIT结构。 ACXCIRCUIT_INIT是用于线路初始化的不透明对象。 使用 AcxCircuitInitAllocate 初始化ACXCIRCUIT_INIT结构。

Categories

包含所需 KSCATERGORY 的 GUIDS 的数组，例如 KSCATEGORY_AUDIO。 有关 KSCATERGORY 条目的详细信息，请参阅 安装音频适配器的设备接口。

CategoriesCount

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

返回值

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