Traduzione di richieste di Speaker-Configuration
Nota Queste informazioni si applicano a Windows XP e ai sistemi operativi precedenti. A partire da Windows Vista, IDirectSound::GetSpeakerConfig e IDirectSound::SetSpeakerConfig sono stati deprecati.
Quando un'applicazione chiama IDirectSound::SetSpeakerConfig (vedere Microsoft Windows SDK documentazione) per modificare la configurazione dell'altoparlante, DirectSound converte il parametro di configurazione dell'altoparlante DSSPEAKER_Xxx specificato nell'equivalente maschera di configurazione del canale KSAUDIO_Xxx. Invia una richiesta KSPROPERTY_AUDIO_CHANNEL_CONFIG set-property contenente questa maschera al filtro che rappresenta il dispositivo DirectSound.
Nella tabella seguente ogni parametro DSSPEAKER_Xxx a sinistra viene associato alla maschera di configurazione del canale KSAUDIO_Xxx equivalente a destra.
| Parametro DSSPEAKER | KSAUDIO Channel-Configuration Mask |
|---|---|
DSSPEAKER_DIRECTOUT |
KSAUDIO_SPEAKER_DIRECTOUT |
DSSPEAKER_HEADPHONE |
KSAUDIO_SPEAKER_STEREO |
DSSPEAKER_MONO |
KSAUDIO_SPEAKER_MONO |
DSSPEAKER_STEREO |
KSAUDIO_SPEAKER_STEREO |
DSSPEAKER_QUAD |
KSAUDIO_SPEAKER_QUAD |
DSSPEAKER_SURROUND |
KSAUDIO_SPEAKER_SURROUND |
DSSPEAKER_5POINT1 |
KSAUDIO_SPEAKER_5POINT1 |
DSSPEAKER_7POINT1 |
KSAUDIO_SPEAKER_7POINT1 |
Nella tabella precedente DirectSound specifica sia le configurazioni della cuffie che dell'altoparlante stereo con la stessa maschera del canale, KSAUDIO_SPEAKER_STEREO. Per distinguere tra queste due configurazioni, DirectSound invia il filtro una seconda richiesta di proprietà set, che specifica una geometria dell'altoparlante (vedere KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY). Per indicare le cuffie, DirectSound passa il valore KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONE con la richiesta geometry dell'altoparlante.
Nel caso degli altoparlanti stereo, tuttavia, il chiamante a SetSpeakerConfig può specificare uno dei diversi possibili geometrie stereo-altoparlanti DSSPEAKER_Xxx . Questi elementi vengono visualizzati nella colonna sinistra della tabella seguente e i parametri KSAUDIO_Xxx equivalenti vengono visualizzati a destra.
| DSSPEAKER Stereo-Speaker Geometry | KSAUDIO Stereo-Speaker Geometry |
|---|---|
DSSPEAKER_GEOMETRY_WIDE |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE |
DSSPEAKER_GEOMETRY_NARROW |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW |
DSSPEAKER_GEOMETRY_MIN |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN |
DSSPEAKER_GEOMETRY_MAX |
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX |
Se il chiamante non specifica in modo esplicito una delle geometrie nella colonna sinistra precedente, DirectSound presuppone DSSPEAKER_GEOMETRY_WIDE per impostazione predefinita.