DVSOUNDDEVICECONFIG

Used to set and retrieve information about the sound device configuration and cannot be changed once a connection has been made. After a connection is made, you can retrieve the current sound device configuration by calling DirectPlayVoiceClient8.GetSoundDeviceConfig.

Type DVSOUNDDEVICECONFIG
    guidCaptureDevice As String
    guidPlaybackDevice As String
    hwndAppWindow As Long
    lFlags As CONST_DVSOUNDEFFECT
    lMainBufferFlags As CONST_DSBPLAYFLAGS
    lMainBufferPriority As Long
    MainSoundBuffer As DirectSoundSecondaryBuffer8
End Type

Members

guidCaptureDevice

When this type is used in DirectPlayVoiceClient8.Connect method, this member specifies the GUID of the device used for capture.

When this type is used in the DirectPlayVoiceClient8.GetSoundDeviceConfig method, this member will contain the actual device GUID used for capture.

guidPlaybackDevice

When this type is used in the DirectPlayVoiceClient8.Connect method, this member specifies the GUID of the device used for playback.

When this type is used in the DirectPlayVoiceClient8.GetSoundDeviceConfig method, this member contains the actual device GUID used for playback.

hwndAppWindow

Must be set to the handle of the window that will be used to determine focus for sound playback. See DirectSound8.SetCooperativeLevel for information on Microsoft® DirectSound® focus. If you do not have a window to use for focus, use GetDesktopWindowHandle to use the desktop window.

lFlags

Combination of the flags from the CONST_DVSOUNDEFFECT enumeration.

lMainBufferFlags

Flags values taken from the CONST_DSBPLAYFLAGS enumeration that specify how to play the buffer.

lMainBufferPriority

Passed directly to the dwPriority parameter of the DirectSoundSecondaryBuffer8.Play method when Play is called on the main buffer.

MainSoundBuffer

DirectSoundSecondaryBuffer8 object, which is used to create the Microsoft DirectPlay® Voice main buffer. This parameter can be either NULL or a user-created DirectSound buffer. If this member is set to NULL, DirectPlay Voice will create a buffer for the main voice buffer. If users specify a buffer here, DirectPlay Voice will use their buffer for the main voice buffer.

• The buffer must be 22 kilohertz, 16-bit, Mono format.
• The buffer must be at least 1 second in length.
• The buffer must have been created with the DSBCAPS_GETCURRENTPOSITION2 and DSBCAPS_CTRL3D flags.
• The buffer must not be a primary buffer.
• The buffer must not be playing when it is passed to DirectPlay.
• The buffer must not be locked when it is passed to DirectPlay.