SYNTH_PORTPARAMS structure (dmusprop.h)
La structure SYNTH_PORTPARAMS contient les paramètres de configuration d’un port DirectMusic, qui est un terme DirectMusic pour un appareil qui envoie ou reçoit des données musicales. (Dans la terminologie KS, un port DirectMusic ne correspond pas à un pilote de port DMus. Il correspond à une broche de rendu ou de capture sur un filtre DirectMusic.)
Syntaxe
typedef struct _SYNTH_PORTPARAMS {
DWORD ValidParams;
DWORD Voices;
DWORD ChannelGroups;
DWORD AudioChannels;
DWORD SampleRate;
DWORD EffectsFlags;
DWORD Share;
} SYNTH_PORTPARAMS, *PSYNTH_PORTPARAMS;
Membres
ValidParams
Spécifie les membres de la structure SYNTH_PORTPARAMS qui contiennent des données valides. Ce membre est un champ de bits dont la valeur est égale à zéro ou au niveau du bit OU d’un ou plusieurs des bits d’indicateur suivants :
SYNTH_PORTPARAMS_VOICES
Le champ Voix est valide.
SYNTH_PORTPARAMS_CHANNELGROUPS
Le champ ChannelGroups est valide.
SYNTH_PORTPARAMS_AUDIOCHANNELS
Le champ AudioChannels est valide.
SYNTH_PORTPARAMS_SAMPLERATE
Le champ SampleRate est valide.
SYNTH_PORTPARAMS_EFFECT
L’indicateur EffectsFlags est valide.
SYNTH_PORTPARAMS_SHARE
Le champ Partager est valide.
Voices
Spécifie le nombre maximal de voix simultanées que l’application souhaite lire sur ce port.
ChannelGroups
Spécifie le nombre de groupes de canaux demandés pour ce port. Chaque groupe de canaux contient 16 canaux.
AudioChannels
Spécifie le nombre de canaux audio.
SampleRate
Spécifie le nombre d’échantillons par seconde pour les données audio produites par le port.
EffectsFlags
Spécifie le type d’effets produits pour la sortie audio à partir de ce port. Ce membre est un champ de bits dont la valeur est égale à zéro ou au niveau du bit OU d’un ou plusieurs des bits d’indicateur suivants :
SYNTH_EFFECT_REVERB
La réverbération est activée.
SYNTH_EFFECT_CHORUS
L’effet chorus est activé.
SYNTH_EFFECT_DELAY
L’effet de retard est activé.
Si aucun effet n’est activé, ce membre est défini sur SYNTH_EFFECT_NONE, soit zéro.
Share
Spécifie si les groupes de canaux du port sont partagés. Lorsque ce membre a la valeur TRUE, tous les ports utilisent les groupes de canaux attribués à ce port. Lorsque ce membre a la valeur FALSE, le port est ouvert en mode exclusif et l’utilisation des mêmes groupes de canaux par d’autres ports n’est pas autorisée.
Remarques
Une requête KSPROPERTY_SYNTH_PORTPARAMETERS get-property utilise la structure SYNTH_PORTPARAMS pour son descripteur de propriété et sa valeur de propriété.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dmusprop.h (inclure Dmusprop.h) |