struttura SYNTH_PORTPARAMS (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;
Membri
ValidParams
Specifica quale dei membri della struttura SYNTH_PORTPARAMS contengono dati validi. Questo membro è un campo di bit il cui valore è zero o or bit per bit di uno o più dei bit di flag seguenti:
SYNTH_PORTPARAMS_VOICES
Il campo voce è valido.
SYNTH_PORTPARAMS_CHANNELGROUPS
Il campo channelgroup è 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 di bit il cui valore è zero o or bit per bit di uno o più dei bit di flag seguenti:
SYNTH_EFFECT_REVERB
Il riverbero è abilitato.
SYNTH_EFFECT_CHORUS
L'effetto chorus è abilitato.
SYNTH_EFFECT_DELAY
L'effetto ritardo è abilitato.
Se non sono abilitati effetti, questo membro viene 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.
Osservazioni
Una richiesta di KSPROPERTY_SYNTH_PORTPARAMETERS get-property usa la struttura SYNTH_PORTPARAMS sia per il descrittore della proprietà che per il relativo valore della proprietà.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | dmusprop.h (include Dmusprop.h) |