SYNTH_PORTPARAMS-Struktur (dmusprop.h)
Die SYNTH_PORTPARAMS-Struktur enthält die Konfigurationsparameter für einen DirectMusic-Port, bei dem es sich um einen DirectMusic-Begriff für ein Gerät handelt, das Musikdaten sendet oder empfängt. (In der KS-Terminologie entspricht ein DirectMusic-Port nicht einem DMus-Porttreiber. Sie entspricht einem Render- oder Erfassungspin in einem DirectMusic-Filter.)
Syntax
typedef struct _SYNTH_PORTPARAMS {
DWORD ValidParams;
DWORD Voices;
DWORD ChannelGroups;
DWORD AudioChannels;
DWORD SampleRate;
DWORD EffectsFlags;
DWORD Share;
} SYNTH_PORTPARAMS, *PSYNTH_PORTPARAMS;
Member
ValidParams
Gibt an, welche der SYNTH_PORTPARAMS Strukturmember gültige Daten enthalten. Dieses Element ist ein Bitfeld, dessen Wert entweder 0 oder der bitweise OR eines oder mehrerer der folgenden Flagbits ist:
SYNTH_PORTPARAMS_VOICES
Das Feld Stimmen ist gültig.
SYNTH_PORTPARAMS_CHANNELGROUPS
Das Feld ChannelGroups ist gültig.
SYNTH_PORTPARAMS_AUDIOCHANNELS
Das Feld AudioChannels ist gültig.
SYNTH_PORTPARAMS_SAMPLERATE
Das Feld SampleRate ist gültig.
SYNTH_PORTPARAMS_EFFECT
Das EffectsFlags-Flag ist gültig.
SYNTH_PORTPARAMS_SHARE
Das Feld Freigeben ist gültig.
Voices
Gibt die maximale Anzahl gleichzeitiger Stimmen an, die die Anwendung an diesem Port wiedergeben möchte.
ChannelGroups
Gibt die Anzahl der für diesen Port angeforderten Kanalgruppen an. Jede Kanalgruppe enthält 16 Kanäle.
AudioChannels
Gibt die Anzahl der Audiokanäle an.
SampleRate
Gibt die Anzahl der Beispiele pro Sekunde für die vom Port erzeugten Audiodaten an.
EffectsFlags
Gibt den Typ der Effekte an, die für die Audioausgabe von diesem Port erzeugt werden. Dieses Element ist ein Bitfeld, dessen Wert entweder 0 oder der bitweise OR eines oder mehrerer der folgenden Flagbits ist:
SYNTH_EFFECT_REVERB
Reverb ist aktiviert.
SYNTH_EFFECT_CHORUS
Der Choruseffekt ist aktiviert.
SYNTH_EFFECT_DELAY
Verzögerungseffekt ist aktiviert.
Wenn keine Effekte aktiviert sind, wird dieser Member auf SYNTH_EFFECT_NONE festgelegt, d. h. 0.
Share
Gibt an, ob die Kanalgruppen des Ports freigegeben werden. Wenn dieses Element TRUE ist, verwenden alle Ports die Kanalgruppen, die diesem Port zugewiesen sind. Wenn dieses Element FALSE ist, wird der Port im exklusiven Modus geöffnet, und die Verwendung derselben Kanalgruppen durch andere Ports ist nicht zulässig.
Hinweise
Eine KSPROPERTY_SYNTH_PORTPARAMETERS get-property-Anforderung verwendet die SYNTH_PORTPARAMS-Struktur sowohl für den Eigenschaftendeskriptor als auch für den Eigenschaftswert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dmusprop.h (include Dmusprop.h) |