KSPROPERTY_AUDIO_CHANNEL_CONFIG

Articolo
06/15/2023

La proprietà KSPROPERTY_AUDIO_CHANNEL_CONFIG specifica il posizionamento spaziale effettivo dei canali nel flusso audio restituito da un nodo.

Tabella riepilogo utilizzo

Recupero	Set	Destinazione	Tipo di descrittore di proprietà	Tipo valore proprietà
Sì	Sì	Filtro/Pin	KSNODEPROPERTY	KSAUDIO_CHANNEL_CONFIG

Il valore della proprietà (dati dell'operazione) è una struttura di tipo KSAUDIO_CHANNEL_CONFIG. Questa struttura specifica i canali contenuti nel flusso di output e l'assegnazione di tali canali agli altoparlanti.

Valore restituito

Una richiesta di proprietà KSPROPERTY_AUDIO_CHANNEL_CONFIG restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.

Commenti

Se usato come proprietà di un nodo di applicazione livello dati (KSNODETYPE_DAC) o un nodo 3D (KSNODETYPE_3D_EFFECTS), la proprietà KSPROPERTY_AUDIO_CHANNEL_CONFIG specifica la configurazione dell'altoparlante DirectSound. Per le configurazioni stereo dell'altoparlante, questa proprietà viene usata insieme alla proprietà KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY , che distingue tra le cuffie e diverse configurazioni altoparlanti stereo. Per altre informazioni sulle configurazioni dell'altoparlante, vedere Impostazioni Speaker-Configuration DirectSound.

DirectSound usa anche la proprietà KSPROPERTY_AUDIO_CHANNEL_CONFIG per eseguire una query su un nodo "pan" per la configurazione del canale. Un nodo panoramica è il secondo nodo del volume (KSNODETYPE_VOLUME) su un pin mixer che soddisfa i requisiti di ordinamento dei nodi DirectSound. L'implementazione DirectSound del metodo IDirectSoundBuffer::SetPan (descritta nella documentazione di Microsoft Windows SDK) usa la proprietà KSPROPERTY_AUDIO_VOLUMELEVEL del nodo di panoramica per controllare la panoramica.

DirectSound considera KSPROPERTY_AUDIO_CHANNEL_CONFIG come proprietà di filtro in un nodo di applicazione livello dati e come proprietà pin nei nodi volume e 3D.

I client usano anche questa proprietà per selezionare il formato del flusso restituito da un nodo KSNODETYPE_PROLOGIC_DECODER .