KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
La propriété KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY est utilisée conjointement avec KSPROPERTY_AUDIO_CHANNEL_CONFIG pour implémenter la propriété de configuration du haut-parleur DirectSound pour l’audio 3D accéléré par le matériel. Il s’agit d’une propriété facultative des nœuds DAC (KSNODETYPE_DAC) et des nœuds 3D (KSNODETYPE_3D_EFFECTS).
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Épingler/filtrer |
LONG |
La valeur de propriété (données d’opération) est de type LONG et spécifie la géométrie de l’orateur. Cette valeur peut être définie sur l’une des constantes suivantes, qui sont définies dans le fichier d’en-tête 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
Les paramètres précédents ont une signification équivalente (mais pas égale en valeur) aux valeurs suivantes, qui sont utilisées par la méthode IDirectSound::GetSpeakerConfig (voir la documentation Microsoft Windows SDK) et sont définies dans le fichier d’en-tête Dsound.h :
DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX
Valeur de retour
Une demande de propriété KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne une erreur appropriée status code.
Notes
DirectSound traite KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY comme une propriété de filtre sur un nœud DAC et comme une propriété d’épingle sur un nœud 3D.
Pour plus d’informations, consultez Paramètres de Speaker-Configuration DirectSound.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |