Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die SYNTH_PORTPARAMS-Struktur enthält die Konfigurationsparameter für einen DirectMusic-Port, der ein DirectMusic-Begriff für ein Gerät ist, das Musikdaten sendet oder empfängt. (In der KS-Terminologie entspricht ein DirectMusic-Port nicht einem DMus-Porttreiber. Er entspricht einem Render- oder Aufnahme-Pin für einen 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;
Angehörige
ValidParams
Gibt an, welche der SYNTH_PORTPARAMS Strukturmmber gültige Daten enthalten. Dieses Element ist ein Bitfeld, dessen Wert entweder null oder der bitweise ODER eines oder mehrerer der folgenden Flagbits ist:
SYNTH_PORTPARAMS_VOICES
Das Feld Stimmen ist gültig.
SYNTH_PORTPARAMS_CHANNELGROUPS
Das ChannelGroups Feld 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 für diesen 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 null oder der bitweise ODER eines oder mehrerer der folgenden Flagbits ist:
SYNTH_EFFECT_REVERB
Hall ist aktiviert.
SYNTH_EFFECT_CHORUS
Der Choreffekt ist aktiviert.
SYNTH_EFFECT_DELAY
Verzögerungseffekt ist aktiviert.
Wenn keine Effekte aktiviert sind, wird dieses Element auf SYNTH_EFFECT_NONE festgelegt, d. h. null.
Share
Gibt an, ob die Kanalgruppen des Ports freigegeben werden. Wenn dieses Mitglied TRUEist, verwenden alle Ports die Kanalgruppen, die diesem Port zugewiesen sind. Wenn dieses Mitglied FALSEist, wird der Port im exklusiven Modus geöffnet und die Verwendung derselben Kanalgruppen durch andere Ports ist nicht zulässig.
Bemerkungen
Eine KSPROPERTY_SYNTH_PORTPARAMETERS get-property-Anforderung verwendet die SYNTH_PORTPARAMS Struktur sowohl für den Eigenschaftsdeskriptor als auch für den Eigenschaftswert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dmusprop.h (include Dmusprop.h) |