AcxFactoryCircuitInitAssignComponentUri 函数 (acxcircuit.h)
AcxFactoryCircuitInitAssignComponentUri 函数分配 URI 字符串作为 ACXFACTORYCIRCUIT 的标识符。
语法
NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PCUNICODE_STRING ComponentUri
);
参数
FactoryInit
用于线路工厂初始化的ACXFACTORYCIRCUIT_INIT结构。 这是一个不透明的结构，用于存储 ACX 线路工厂初始化信息并将工厂与 WDF 设备相关联。
使用 AcxFactoryCircuitInitAllocate 函数 初始化 ACXFACTORYCIRCUIT_INIT 结构。
ComponentUri
描述组件的 unicode 字符串。
返回值
STATUS_SUCCESS如果调用成功，则返回 。 否则，它将返回相应的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。
注解
驱动程序必须通过将线路工厂的 URI 和/或其 ID (AcxCircuitInitSetComponentId) 来初始化其标识。
示例
示例用法如下所示。
DECLARE_CONST_UNICODE_STRING(dspFactoryName, L"DspFactoryCircuit");
DECLARE_CONST_UNICODE_STRING(dspFactoryUri, L"URI_Goes_Here");
//
// Get a FactoryCircuitInit structure.
//
PACXFACTORYCIRCUIT_INIT factoryInit = NULL;
factoryInit = AcxFactoryCircuitInitAllocate(Device);
//
// Add factory identifiers.
//
status = cxFactoryCircuitInitAssignComponentUri(factoryInit, &dspFactoryUri);
status = AcxFactoryCircuitInitAssignName(factoryInit, &dspFactoryName);
ACX 要求
最低 ACX 版本： 1.0
有关 ACX 版本的详细信息，请参阅 ACX 版本概述。
要求
| 要求 | 值 |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |