KSPROPERTY_AUDIO_CHANNEL_CONFIG
La propiedad KSPROPERTY_AUDIO_CHANNEL_CONFIG especifica la ubicación espacial real de los canales en la secuencia de audio que genera un nodo.
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Sí |
Sí |
Filtrar/anclar |
KSNODEPROPERTY |
El valor de propiedad (datos de operación) es una estructura de tipo KSAUDIO_CHANNEL_CONFIG. Esta estructura especifica los canales contenidos en el flujo de salida y la asignación de esos canales a los altavoces.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_AUDIO_CHANNEL_CONFIG devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.
Observaciones
Cuando se usa como propiedad de un nodo DAC (KSNODETYPE_DAC) o un nodo 3D (KSNODETYPE_3D_EFFECTS), la propiedad KSPROPERTY_AUDIO_CHANNEL_CONFIG especifica la configuración del altavoz DirectSound. Para las configuraciones de altavoz estéreo, esta propiedad se usa junto con la propiedad KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY , que distingue entre auriculares y varias configuraciones de altavoz estéreo. Para obtener más información sobre las configuraciones de altavoz, vea DirectSound Speaker-Configuration Settings.
DirectSound también usa la propiedad KSPROPERTY_AUDIO_CHANNEL_CONFIG para consultar un nodo "panorámico" para su configuración de canal. Un nodo panorámico es el segundo nodo de volumen (KSNODETYPE_VOLUME) en un pin mezclador que cumple los requisitos de ordenación de nodos de DirectSound. La implementación de DirectSound del método IDirectSoundBuffer::SetPan (descrita en la documentación de Microsoft Windows SDK) usa la propiedad KSPROPERTY_AUDIO_VOLUMELEVEL del nodo panorámico para controlar el movimiento panorámico.
DirectSound trata KSPROPERTY_AUDIO_CHANNEL_CONFIG como una propiedad de filtro en un nodo DAC y como una propiedad pin en los nodos de volumen y 3D.
Los clientes también usan esta propiedad para seleccionar el formato de la secuencia que genera un nodo KSNODETYPE_PROLOGIC_DECODER .
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |