SYNTH_PORTPARAMS struttura (dmusprop.h)

La struttura SYNTH_PORTPARAMS contiene i parametri di configurazione per una porta DirectMusic, ovvero un termine DirectMusic per un dispositivo che invia o riceve dati musicali. (Nella terminologia KS, una porta DirectMusic non corrisponde a un driver di porta DMus. Corrisponde a un pin di rendering o acquisizione su un filtro DirectMusic.

Sintassi

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

Members

ValidParams

Specifica quale dei membri della struttura SYNTH_PORTPARAMS contengono dati validi. Questo membro è un campo bit il cui valore è zero o l'OR bit per bit di uno o più dei bit di flag seguenti:

SYNTH_PORTPARAMS_VOICES

Il campo Voices è valido.

SYNTH_PORTPARAMS_CHANNELGROUPS

Il campo ChannelGroups è valido.

SYNTH_PORTPARAMS_AUDIOCHANNELS

Il campo AudioChannels è valido.

SYNTH_PORTPARAMS_SAMPLERATE

Il campo SampleRate è valido.

SYNTH_PORTPARAMS_EFFECT

Il flag EffectsFlags è valido.

SYNTH_PORTPARAMS_SHARE

Il campo Condividi è valido.

Voices

Specifica il numero massimo di voci simultanee che l'applicazione desidera riprodurre su questa porta.

ChannelGroups

Specifica il numero di gruppi di canali richiesti per questa porta. Ogni gruppo di canali contiene 16 canali.

AudioChannels

Specifica il numero di canali audio.

SampleRate

Specifica il numero di campioni al secondo per i dati audio prodotti dalla porta.

EffectsFlags

Specifica il tipo di effetti prodotti per l'output audio da questa porta. Questo membro è un campo bit il cui valore è zero o l'OR bit per bit di uno o più dei bit di flag seguenti:

SYNTH_EFFECT_REVERB

Il reverb è abilitato.

SYNTH_EFFECT_CHORUS

L'effetto del coro è abilitato.

SYNTH_EFFECT_DELAY

L'effetto ritardo è abilitato.

Se non vengono abilitati effetti, questo membro è impostato su SYNTH_EFFECT_NONE, ovvero zero.

Share

Specifica se i gruppi di canali della porta sono condivisi. Quando questo membro è TRUE, tutte le porte usano i gruppi di canali assegnati a questa porta. Quando questo membro è FALSE, la porta viene aperta in modalità esclusiva e l'uso degli stessi gruppi di canali da altre porte non è consentito.

Commenti

Una richiesta di KSPROPERTY_SYNTH_PORTPARAMETERS get-property usa la struttura di SYNTH_PORTPARAMS sia per il descrittore della proprietà che per il relativo valore di proprietà.

Requisiti

Vedi anche

KSPROPERTY_SYNTH_PORTPARAMETERS