SYNTH_PORTPARAMS 구조체(dmusprop.h)

SYNTH_PORTPARAMS 구조에는 음악 데이터를 보내거나 받는 디바이스의 DirectMusic 용어인 DirectMusic 포트에 대한 구성 매개 변수가 포함됩니다. (KS 용어에서 DirectMusic 포트는 DMus 포트 드라이버에 해당하지 않습니다. DirectMusic 필터의 렌더링 또는 캡처 핀에 해당합니다.)

구문

typedef struct _SYNTH_PORTPARAMS {
  DWORD ValidParams;
  DWORD Voices;
  DWORD ChannelGroups;
  DWORD AudioChannels;
  DWORD SampleRate;
  DWORD EffectsFlags;
  DWORD Share;
} SYNTH_PORTPARAMS, *PSYNTH_PORTPARAMS;

멤버

ValidParams

유효한 데이터가 포함된 SYNTH_PORTPARAMS 구조체 멤버를 지정합니다. 이 멤버는 값이 0이거나 다음 플래그 비트 중 하나 이상의 비트 OR인 비트 필드입니다.

SYNTH_PORTPARAMS_VOICES

음성 필드가 유효합니다.

SYNTH_PORTPARAMS_CHANNELGROUPS

ChannelGroups 필드는 유효합니다.

SYNTH_PORTPARAMS_AUDIOCHANNELS

AudioChannels 필드는 유효합니다.

SYNTH_PORTPARAMS_SAMPLERATE

SampleRate 필드는 유효합니다.

SYNTH_PORTPARAMS_EFFECT

EffectsFlags 플래그가 유효합니다.

SYNTH_PORTPARAMS_SHARE

공유 필드가 유효합니다.

Voices

애플리케이션이 이 포트에서 재생하려는 최대 동시 음성 수를 지정합니다.

ChannelGroups

이 포트에 대해 요청된 채널 그룹의 수를 지정합니다. 각 채널 그룹에는 16개의 채널이 포함됩니다.

AudioChannels

오디오 채널 수를 지정합니다.

SampleRate

포트에서 생성된 오디오 데이터의 초당 샘플 수를 지정합니다.

EffectsFlags

이 포트의 오디오 출력에 대해 생성되는 효과의 유형을 지정합니다. 이 멤버는 값이 0이거나 다음 플래그 비트 중 하나 이상의 비트 OR인 비트 필드입니다.

SYNTH_EFFECT_REVERB

반향을 사용할 수 있습니다.

SYNTH_EFFECT_CHORUS

코러스 효과를 사용할 수 있습니다.

SYNTH_EFFECT_DELAY

지연 효과가 사용하도록 설정됩니다.

효과를 사용하도록 설정하지 않으면 이 멤버는 0인 SYNTH_EFFECT_NONE 로 설정됩니다.

Share

포트의 채널 그룹을 공유할지 여부를 지정합니다. 이 멤버가 TRUE이면 모든 포트는 이 포트에 할당된 채널 그룹을 사용합니다. 이 멤버가 FALSE이면 포트가 배타적 모드로 열리고 다른 포트에서 동일한 채널 그룹을 사용할 수 없습니다.

설명

KSPROPERTY_SYNTH_PORTPARAMETERS get-property 요청은 속성 설명자와 해당 속성 값 모두에 SYNTH_PORTPARAMS 구조를 사용합니다.

요구 사항

요구 사항	값
헤더	dmusprop.h(Dmusprop.h 포함)

추가 정보

KSPROPERTY_SYNTH_PORTPARAMETERS