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 |