Share via


Función AcxCircuitInitAssignName (acxcircuit.h)

La función AcxCircuitInitAssignName asigna un nombre descriptivo para ACXCIRCUIT.

Sintaxis

NTSTATUS AcxCircuitInitAssignName(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING CircuitName
);

Parámetros

CircuitInit

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

CircuitName

Cadena unicode con el nombre del circuito, como Microphone0.

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

La cadena CircuitName debe coincidir con la cadena INF que identifica la interfaz de audio.

Ejemplo

A continuación se muestra un ejemplo de uso.

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

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

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

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

Requisito Valor
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Consulte también