estructura SYNTH_PORTPARAMS (dmusprop.h)
La estructura SYNTH_PORTPARAMS contiene los parámetros de configuración de un puerto de DirectMusic, que es un término de DirectMusic para un dispositivo que envía o recibe datos de música. (En la terminología de KS, un puerto de DirectMusic no corresponde a un controlador de puerto DMus. Corresponde a un pin de representación o captura en un filtro DirectMusic).
Sintaxis
typedef struct _SYNTH_PORTPARAMS {
DWORD ValidParams;
DWORD Voices;
DWORD ChannelGroups;
DWORD AudioChannels;
DWORD SampleRate;
DWORD EffectsFlags;
DWORD Share;
} SYNTH_PORTPARAMS, *PSYNTH_PORTPARAMS;
Miembros
ValidParams
Especifica cuáles de los miembros de la estructura SYNTH_PORTPARAMS contienen datos válidos. Este miembro es un campo de bits cuyo valor es cero o el or bit a bit de uno o varios de los siguientes bits de marca:
SYNTH_PORTPARAMS_VOICES
El campo Voces es válido.
SYNTH_PORTPARAMS_CHANNELGROUPS
El campo ChannelGroups es válido.
SYNTH_PORTPARAMS_AUDIOCHANNELS
El campo AudioChannels es válido.
SYNTH_PORTPARAMS_SAMPLERATE
El campo SampleRate es válido.
SYNTH_PORTPARAMS_EFFECT
La marca EffectsFlags es válida.
SYNTH_PORTPARAMS_SHARE
El campo Compartir es válido.
Voices
Especifica el número máximo de voces simultáneas que la aplicación desea reproducir en este puerto.
ChannelGroups
Especifica el número de grupos de canales solicitados para este puerto. Cada grupo de canales contiene 16 canales.
AudioChannels
Especifica el número de canales de audio.
SampleRate
Especifica el número de muestras por segundo para los datos de audio generados por el puerto.
EffectsFlags
Especifica el tipo de efectos producidos para la salida de audio de este puerto. Este miembro es un campo de bits cuyo valor es cero o el or bit a bit de uno o varios de los siguientes bits de marca:
SYNTH_EFFECT_REVERB
La reverberación está habilitada.
SYNTH_EFFECT_CHORUS
El efecto chorus está habilitado.
SYNTH_EFFECT_DELAY
El efecto de retraso está habilitado.
Si no hay efectos habilitados, este miembro se establece en SYNTH_EFFECT_NONE, que es cero.
Share
Especifica si se comparten los grupos de canales del puerto. Cuando este miembro es TRUE, todos los puertos usan los grupos de canales asignados a este puerto. Cuando este miembro es FALSE, el puerto se abre en modo exclusivo y no se permite el uso de los mismos grupos de canales por otros puertos.
Comentarios
Una solicitud de KSPROPERTY_SYNTH_PORTPARAMETERS get-property usa la estructura SYNTH_PORTPARAMS tanto para su descriptor de propiedad como para su valor de propiedad.
Requisitos
| Requisito | Valor |
|---|---|
| Header | dmusprop.h (incluir Dmusprop.h) |