KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
La propiedad KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY se usa en combinación con KSPROPERTY_AUDIO_CHANNEL_CONFIG para implementar la propiedad de configuración del altavoz directSound para audio 3D acelerado por hardware. Se trata de una propiedad opcional de nodos DAC (KSNODETYPE_DAC) y nodos 3D (KSNODETYPE_3D_EFFECTS).
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Sí |
Sí |
Anclar o filtrar |
LONG |
El valor de propiedad (datos de operación) es de tipo LONG y especifica la geometría del altavoz. Este valor se puede establecer en una de las siguientes constantes, que se definen en el archivo de encabezado Ksmedia.h:
KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONES
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX
Los parámetros anteriores son equivalentes en significado (pero no iguales en valor) a los siguientes valores, que se usan en el método IDirectSound::GetSpeakerConfig (vea la documentación de Microsoft Windows SDK) y se definen en el archivo de encabezado Dsound.h:
DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX
Valor devuelto
Una solicitud de propiedad KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY 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
DirectSound trata KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY como una propiedad de filtro en un nodo DAC y como una propiedad pin en un nodo 3D.
Para obtener más información, consulte Configuración de DirectSound Speaker-Configuration.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |