KSPROPERTY_AUDIOLOOPBACK
La propiedad KSPROPERTY_AUDIOLOOPBACK indica si el punto de derivación de bucle invertido es antes o después del volumen y del silencio.
A partir de la versión Windows 11 24H2, es obligatorio activar la propiedad KSPROPERTY_AUDIOLOOPBACK.
Tabla de resumen de uso
| Obtener Yammer | Establecer | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
| Sí | No | Pin | KSATTRIBUTE_AUDIOLOOPBACK_TAPPOINT | Estructura KSATTRIBUTE structure |
KSPROPERTY_AUDIOLOOPBACK es una enumeración de propiedades asociadas a KSPROPSETID_AudioLoopback, con la siguiente propiedad implementada.
typedef enum {
KSPROPERTY_AUDIOLOOPBACK_TAPPOINT_CAPS,
} KSPROPERTY_AUDIOLOOPBACK;
El AudioEndpointBuilder de Windows usa KSPROPSETID_AudioLoopback con KSPROPERTY_AUDIOLOOPBACK_TAPPOINT_CAPS para recuperar AUDIOLOOPBACK_TAPPOINT_CAPS_<*>. Esto informa al sistema operativo sobre si el punto de conexión de audio tiene la capacidad de realizar un bucle invertido de volumen previo, un bucle invertido de volumen posterior o ambos.
Después, en el momento crearse los pines, el sistema operativo usa un atributo, KSATTRIBUTEID_AUDIOLOOPBACK_TAPPOINT con un KSATTRIBUTE_AUDIOLOOPBACK_TAPPOINT, para comunicar si se debe crear el pin de bucle invertido como volumen previo o posterior.
Los límites de puntos de derivación se definen de la manera siguiente.
#define AUDIOLOOPBACK_TAPPOINT_CAPS_PREVOLUMEMUTE (0x1)
#define AUDIOLOOPBACK_TAPPOINT_CAPS_POSTVOLUMEMUTE (0x2)
La estructura KSATTRIBUTE_AUDIOLOOPBACK_TAPPOINT disponible en ksmedia.h puede habilitar un contenedor para especificar el atributo AUDIO_LOOPBACK_TAPPOINT_TYPE sobre dónde derivar el bucle invertido en el gráfico de transmisión.
Valor devuelto
La solicitud de propiedad KSPROPERTY_AUDIOLOOPBACK devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve el código de estado de error correspondiente.
Comentarios
Un sistema de audio se puede resumir tal como se indica a continuación.
- Salida de procesamiento de señal: La salida del procesamiento de señal descargada o directo del proveedor host.
- Volumen: El siguiente paso del flujo, donde se ajusta el volumen de la señal de audio.
- Silencio: En esta fase se silencia la señal de audio si es necesario.
- EFX (Efectos): Aquí los efectos se aplican a la señal de audio.
- Salida: Fase final en la que se genera la señal de audio procesada.
Los sistemas con motor de audio basado en hardware deben implementar un pin de bucle invertido. El pin de bucle invertido genera una salida de audio mixta después de aplicar todo el procesamiento de señal.
La transmisión de bucle invertido también se ve afectada por el volumen del punto de conexión y el silencio. Esta propiedad permite a las aplicaciones elegir si se debe devolver la transmisión de bucle invertido antes o después de aplicar el volumen del punto de conexión y el silencio.
El controlador de audio debe conectar el pin de salida del motor de audio al pin de bucle invertido del filtro. El pin de bucle invertido debe expresar la categoría como KSNODETYPE_AUDIO_LOOPBACK. El bucle invertido no implementa modos de procesamiento de señal.
El sistema operativo puede consultar el controlador de audio para obtener funcionalidades de punto de derivación de bucle invertido. Las funcionalidades se devuelven como máscara de bits de indicadores.
La transmisión creada en el pin de bucle invertido toma la salida mixta de DSP y la habilita como una transmisión de captura al sistema operativo. Con atributos de transmisión, se puede hacer que el controlador reciba opciones del sistema operativo. Si no se aplican atributos a la transmisión de bucle invertido, se debe captura el bucle invertido antes de aplicar el volumen y el silencio en la salida del mezclador.
En un cliente en modo de usuario, el cambio entre el bucle invertido de volumen previo y el bucle invertido de volumen posterior se realiza a través de AUDCLNT_STREAMOPTIONS_POST_VOLUME_LOOPBACK, pasado como un AUDCLNT_STREAMOPTIONS (audioclient.h) al llamar a SetClientProperties.
KSNODETYPE_AUDIO_LOOPBACK
KSNODETYPE_AUDIO_LOOPBACK representa las funcionalidades de bucle invertido de audio. Se define en ksmedia.h, tal como se muestra aquí.
#define STATIC_KSNODETYPE_AUDIO_LOOPBACK\
0x8f42c0b2, 0x91ce, 0x4bcf, 0x9c, 0xcd, 0xe, 0x59, 0x90, 0x37, 0xab, 0x35
DEFINE_GUIDSTRUCT("8F42C0B2-91CE-4BCF-9CCD-0E599037AB35", KSNODETYPE_AUDIO_LOOPBACK);
#define KSNODETYPE_AUDIO_LOOPBACK DEFINE_GUIDNAMED(KSNODETYPE_AUDIO_LOOPBACK)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 24H2 |
| Encabezado | Ksmedia.h |