estrutura SYNTH_PORTPARAMS (dmusprop.h)
A estrutura SYNTH_PORTPARAMS contém os parâmetros de configuração de uma porta DirectMusic, que é um termo DirectMusic para um dispositivo que envia ou recebe dados de música. (Na terminologia do KS, uma porta DirectMusic não corresponde a um driver de porta DMus. Ele corresponde a um pino de renderização ou captura em um filtro DirectMusic.)
Sintaxe
typedef struct _SYNTH_PORTPARAMS {
DWORD ValidParams;
DWORD Voices;
DWORD ChannelGroups;
DWORD AudioChannels;
DWORD SampleRate;
DWORD EffectsFlags;
DWORD Share;
} SYNTH_PORTPARAMS, *PSYNTH_PORTPARAMS;
Membros
ValidParams
Especifica qual dos membros da estrutura SYNTH_PORTPARAMS contêm dados válidos. Esse membro é um campo de bits cujo valor é zero ou or bit a bit de um ou mais dos seguintes bits de sinalizador:
SYNTH_PORTPARAMS_VOICES
O campo vozes é válido.
SYNTH_PORTPARAMS_CHANNELGROUPS
O campo ChannelGroups é válido.
SYNTH_PORTPARAMS_AUDIOCHANNELS
O campo AudioChannels é válido.
SYNTH_PORTPARAMS_SAMPLERATE
O campo SampleRate é válido.
SYNTH_PORTPARAMS_EFFECT
O sinalizador EffectsFlags é válido.
SYNTH_PORTPARAMS_SHARE
O campo Compartilhar é válido.
Voices
Especifica o número máximo de vozes simultâneas que o aplicativo deseja reproduzir nesta porta.
ChannelGroups
Especifica o número de grupos de canais solicitados para essa porta. Cada grupo de canais contém 16 canais.
AudioChannels
Especifica o número de canais de áudio.
SampleRate
Especifica o número de exemplos por segundo para os dados de áudio produzidos pela porta.
EffectsFlags
Especifica o tipo de efeitos produzidos para a saída de áudio dessa porta. Esse membro é um campo de bits cujo valor é zero ou or bit a bit de um ou mais dos seguintes bits de sinalizador:
SYNTH_EFFECT_REVERB
O Reverb está habilitado.
SYNTH_EFFECT_CHORUS
O efeito de coro está habilitado.
SYNTH_EFFECT_DELAY
O efeito de atraso está habilitado.
Se nenhum efeito estiver habilitado, esse membro será definido como SYNTH_EFFECT_NONE, que é zero.
Share
Especifica se os grupos de canais da porta são compartilhados. Quando esse membro é VERDADEIRO, todas as portas usam os grupos de canais atribuídos a essa porta. Quando esse membro é FALSE, a porta é aberta no modo exclusivo e o uso dos mesmos grupos de canais por outras portas não é permitido.
Observações
Uma solicitação de propriedade de obtenção KSPROPERTY_SYNTH_PORTPARAMETERS usa a estrutura SYNTH_PORTPARAMS para seu descritor de propriedade e seu valor de propriedade.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | dmusprop.h (inclua Dmusprop.h) |