SYNTH_PORTPARAMS-Struktur (dmusprop.h)

  • Artikel

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)

Weitere Informationen

KSPROPERTY_SYNTH_PORTPARAMETERS