AcxCircuitInitAssignName 函数 (acxcircuit.h)

AcxCircuitInitAssignName 函数为 ACXCIRCUIT 分配友好名称。

语法

NTSTATUS AcxCircuitInitAssignName(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING CircuitName
);

参数

CircuitInit

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

CircuitName

具有线路名称的 unicode 字符串，例如 Microphone0。

返回值

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

注解

CircuitName 字符串必须与标识音频接口的 INF 字符串匹配。

示例

示例用法如下所示。

    // Circuit Name
    DECLARE_CONST_UNICODE_STRING(circuitName, L"Microphone0");

    //
    // Add circuit identifiers.
    //
    AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求	值
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

另请参阅

• acxcircuit.h 标头