DMUS_PORTPARAMS8
Contains parameters for the opening of a DirectMusic port. These parameters are passed in when the IDirectMusic8::CreatePort method is called.
The define DMUS_PORTPARAMS resolves to DMUS_PORTPARAMS8. This structure supersedes the earlier version of DMUS_PORTPARAMS, which is now declared as DMUS_PORTPARAMS7.
typedef struct _DMUS_PORTPARAMS8 {
DWORD dwSize;
DWORD dwValidParams;
DWORD dwVoices;
DWORD dwChannelGroups;
DWORD dwAudioChannels;
DWORD dwSampleRate;
DWORD dwEffectFlags;
DWORD fShare;
DWORD dwFeatures;
} DMUS_PORTPARAMS8;
typedef DMUS_PORTPARAMS8 DMUS_PORTPARAMS;
typedef DMUS_PORTPARAMS *LPDMUS_PORTPARAMS;
Members
- dwSize
- Size of the structure, in bytes. This member must be initialized to sizeof(DMUS_PORTPARAMS8) before the structure is passed to a method.
- dwValidParams
- Specifies which members in this structure are valid. Setting the flag for a particular port parameter means that you want to have this parameter set on the method call or want to override the default value when the port is created. The following flags have been defined:
- DMUS_PORTPARAMS_VOICES
DMUS_PORTPARAMS_CHANNELGROUPS
DMUS_PORTPARAMS_AUDIOCHANNELS
DMUS_PORTPARAMS_SAMPLERATE
DMUS_PORTPARAMS_EFFECTS
DMUS_PORTPARAMS_SHARE
DMUS_PORTPARAMS_FEATURES
- dwVoices
- Number of voices required on this port. This is not an absolute maximum; the port can create additional temporary voices to enable smooth transitions when lower-priority voices have to be dropped.
- dwChannelGroups
- Number of channel groups to be allocated on this port. Must be less than or equal to the number of channel groups specified in the DMUS_PORTCAPS structure returned by the IDirectMusic8::EnumPort and IDirectMusicPort8::GetCaps methods.
- dwAudioChannels
- Desired number of output channels.
- dwSampleRate
- Desired sample rate, in hertz.
- dwEffectFlags
- Flags indicating which special effects are desired. The following flags are defined:
DMUS_EFFECT_NONE
DMUS_EFFECT_REVERB
DMUS_EFFECT_CHORUS
- fShare
- If TRUE, all ports use the channel groups assigned to this port. If FALSE, the port is opened in exclusive mode, and the use of the same channel groups by other ports is forbidden.
- dwFeatures
- Miscellaneous capabilities of the port. The following values are defined.
- DMUS_PORT_FEATURE_AUDIOPATH
- Supports an audiopath connection to DirectSound buffers.
- DMUS_PORT_FEATURE_STREAMING
- Supports streaming waves through the synthesizer.
Remarks
The DMUS_PORTPARAMS structure from versions prior to DirectX 8.0 is maintained in Dmusicc.h as DMUS_PORTPARAMS7.
Header: Declared in dmusicc.h.
See Also
DMUS_PORTCAPS