通过

AcxFactoryCircuitInitAssignName 函数 （acxcircuit.h）

  • 项目

AcxFactoryCircuitInitAssignName 函数为 ACXFACTORYCIRCUIT 分配友好名称。

语法

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

参数

FactoryInit

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

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

FactoryName

具有线路工厂名称的 unicode 字符串，例如 Factory_Microphone。

返回值

如果调用成功，则返回 STATUS_SUCCESS。 否则，它将返回适当的错误代码。 有关详细信息，请参阅 使用 NTSTATUS 值。

言论

例

示例用法如下所示。

//
// Factory Name.
//
DECLARE_CONST_UNICODE_STRING(s_FactoryName, L"Render");
    
    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY, 1);
    AcxFactoryCircuitInitAssignName(factoryInit, &s_FactoryName);

ACX 要求

最低 ACX 版本： 1.0

有关 ACX 版本的详细信息，请参阅 ACX 版本概述。

要求

要求 价值
标头 acxcircuit.h
IRQL PASSIVE_LEVEL

另请参阅