Compartilhar via

estrutura SYNTH_PORTPARAMS (dmusprop.h)

  • Artigo

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. 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 o 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 nessa 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 amostras 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 o 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 chorus 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 é TRUE, 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.

Comentários

Um KSPROPERTY_SYNTH_PORTPARAMETERS solicitação get-property 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)

Confira também

KSPROPERTY_SYNTH_PORTPARAMETERS