AcxCircuitInitAssignComponentUri 函式 (acxcircuit.h)

AcxCircuitInitAssignComponentUri 函式會將 URI 字串指派為 ACXCIRCUIT 的標識碼。

語法

NTSTATUS AcxCircuitInitAssignComponentUri(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING ComponentUri
);

參數

CircuitInit

定義線路初始化的 ACXCIRCUIT_INIT 結構。 ACXCIRCUIT_INIT是用於線路初始化的不透明物件。 使用 AcxCircuitInitAllocate 初始化ACXCIRCUIT_INIT結構。

ComponentUri

Unicode 字串，描述可唯一識別 ACXCIRCUIT 的 URI。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

驅動程式必須藉由設定線路的 URI 和/或標識碼 (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 版本概觀。

規格需求

需求	值
標頭	acxcircuit.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxcircuit.h 標頭