Función AcxCircuitInitAssignComponentUri (acxcircuit.h)

La función AcxCircuitInitAssignComponentUri asigna una cadena de URI como identificador para ACXCIRCUIT.

Sintaxis

NTSTATUS AcxCircuitInitAssignComponentUri(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING ComponentUri
);

Parámetros

CircuitInit

Estructura ACXCIRCUIT_INIT que define la inicialización del circuito. ACXCIRCUIT_INIT es un objeto opaco utilizado para la inicialización del circuito. Use AcxCircuitInitAllocate para inicializar la estructura de ACXCIRCUIT_INIT.

ComponentUri

Cadena unicode que describe el URI que identifica de forma única el ACXCIRCUIT.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

El controlador debe inicializar la identidad del circuito estableciendo su URI o su identificador (AcxCircuitInitSetComponentId).

Ejemplo

A continuación se muestra el uso de ejemplo.

    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);

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Consulte también

• encabezado acxcircuit.h