AcxCircuitInitAssignComponentUri 函数 (acxcircuit.h)

AcxCircuitInitAssignComponentUri 函数将 URI 字符串分配为 ACXCIRCUIT 的 ID。

语法

NTSTATUS AcxCircuitInitAssignComponentUri(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING ComponentUri
);

参数

CircuitInit

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

ComponentUri

描述唯一标识 ACXCIRCUIT 的 URI 的 unicode 字符串。

返回值

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

注解

驱动程序必须通过将线路的 URI 和/或其 ID (AcxCircuitInitSetComponentId) 来初始化线路的标识。

示例

示例用法如下所示。

    DECLARE_CONST_UNICODE_STRING(CODEC_CIRCUIT_CAPTURE_URI, L"acx:test:acxcodectestdriver:codec0:circuit0:microphone0");

    // Get a CircuitInit structure.
    //
    circuitInit = AcxCircuitInitAllocate(Device);

    //
    // Add circuit identifiers.
    //
    status = AcxCircuitInitAssignComponentUri(circuitInit, &CODEC_CIRCUIT_CAPTURE_URI);

ACX 要求

最低 ACX 版本： 1.0

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

要求

要求	值
Header	acxcircuit.h
IRQL	PASSIVE_LEVEL

另请参阅

• acxcircuit.h 标头