KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
La proprietà KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY viene usata in combinazione con KSPROPERTY_AUDIO_CHANNEL_CONFIG per implementare la proprietà di configurazione dell'altoparlante DirectSound per l'audio 3D con accelerazione hardware. Si tratta di una proprietà facoltativa dei nodi di applicazione livello dati (KSNODETYPE_DAC) e dei nodi 3D (KSNODETYPE_3D_EFFECTS).
Tabella riepilogo utilizzo
Recupero | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
---|---|---|---|---|
Sì |
Sì |
Aggiungi/Filtro |
LONG |
Il valore della proprietà (dati dell'operazione) è di tipo LONG e specifica la geometria del parlante. Questo valore può essere impostato su una delle costanti seguenti, definite nel file di intestazione 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
I parametri precedenti sono equivalenti nel significato (ma non uguale a valore) ai valori seguenti, usati dal metodo IDirectSound::GetSpeakerConfig (vedere la documentazione di Microsoft Windows SDK) e definiti nel file di intestazione Dsound.h:
DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX
Valore restituito
Una richiesta di proprietà KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
DirectSound considera KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY come proprietà di filtro in un nodo di applicazione livello dati e come proprietà pin in un nodo 3D.
Per altre informazioni, vedere Impostazioni Speaker-Configuration DirectSound.
Requisiti
Intestazione |
Ksmedia.h (include Ksmedia.h) |