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 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |