DVCLIENTCONFIG

Controls the run-time parameters for the client. This type is first used in the call to DirectPlayVoiceClient8.Connect, where it sets the initial state of these parameters. The type can be retrieved after a connection has been made by calling DirectPlayVoiceClient8.GetClientConfig, and set using DirectPlayVoiceClient8.SetClientConfig.

Type DVCLIENTCONFIG
    lBufferAggressiveness As CONST_DVBUFFERAGGRESSIVENESS
    lBufferQuality As CONST_DVBUFFERQUALITY
    lFlags As CONST_DVCLIENTCONFIGENUM
    lNotifyPeriod As Long
    lPlaybackVolume As Long
    lRecordVolume As Long
    lThreshold As CONST_DVTHRESHOLD
End Type

Members

lBufferAggressiveness

One of the constants of the CONST_DVBUFFERAGGRESSIVENESS enumeration that specifies the buffer aggressiveness setting for the adaptive buffer algorithm.

lBufferQuality

One of the constants of the CONST_DVBUFFERQUALITY enumeration that specifies the buffer quality setting for the adaptive buffering algorithm. For most applications, this should be set to DVBUFFERQUALITY_DEFAULT. It can be set to anything in the range of DVBUFFERQUALITY_MIN to DVBUFFERQUALITY_MAX. In general, the higher the value, the higher the quality of the voice but the higher the latency. The lower the value, the lower the latency but the lower the quality.

lFlags

Combination of flags from the CONST_DVCLIENTCONFIGENUM enumeration.

lNotifyPeriod

Specifies how often you want to receive DVMSGID_OUTPUTLEVEL and DVMSGID_INPUTLEVEL (if session is full duplex) messages. If this value is set to 0, these messages are disabled. The value specifies the number of milliseconds between these messages. DVNOTIFYPERIOD_MINPERIOD specifies the minimum period between messages that is allowed.

lPlaybackVolume

Specifies what the volume of the playback should be set to. Adjusting this volume adjusts both the main buffer and all 3-D sound buffers. See the DirectSoundPrimaryBuffer8.SetVolume method for the valid values for this member. You can specify DVPLAYBACKVOLUME_DEFAULT to use a default value that is appropriate for most situations (full volume).

lRecordVolume

Specifies what the volume of the recording should be set to. See the DirectSoundPrimaryBuffer8.SetVolume method for the valid values for this member.

If automatic gain control is enabled, this value can be set to DVRECORDVOLUME_LAST, which tells the system to use the current volume as determined by the automatic gain control algorithm. If a value other then DVRECORDVOLUME_LAST is specified in combination with automatic gain control, this value will be used to restart the algorithm at the specified value.

On return from a call to DirectPlayVoiceClient8.GetClientConfig, this value will contain the current recording volume. When adjusting the recording volume, Microsoft® DirectPlay® Voice will adjust the volume for the microphone (if a microphone volume is present for the card) and the master recording volume (if one is present on the card). If neither a microphone volume nor a master record volume is present, DirectPlay Voice will be unable to adjust the recording volume.

lThreshold

One of the constants of the CONST_DVTHRESHOLD enumeration that specifies the input level used to trigger voice transmission if the DVCLIENTCONFIG_MANUALVOICEACTIVATED flag is specified in the lFlags member. When the flag is specified, this value can be set to anywhere in the range of DVTHRESHOLD_MIN to DVTHRESHOLD_MAX. Additionally, DVTHRESHOLD_DEFAULT can be set to use a default value.

If DVCLIENTCONFIG_MANUALVOICEACTIVATED or DVCLIENTCONFIG_AUTOVOICEACTIVATED is not specified in the lFlags member of this type (indicating push-to-talk mode) this value must be set to DVTHRESHOLD_UNUSED.