Microsoft DirectX 8.0 (Visual Basic) |
Microphone setup is supported by the DirectPlayVoiceTest8.CheckAudioSetup method.
Calling this method invokes the DirectX audio setup wizard, which runs tests and confirms that the system properly supports full duplex operation and ensures microphone and playback settings are correct. You need to run the wizard only once for each combination of playback and capture device you select. Each time your application starts, you should test the configuration by calling DirectPlayVoiceTest8.CheckAudioSetup with the lFlags parameter set to DVFLAGS_QUERYONLY. This enables you to quickly test whether the device configuration has changed since your devices were last tested. If your devices have not been tested, you should run DirectPlayVoiceTest8.CheckAudioSetup again to invoke the wizard. If the configuration has changed since the last test and you have not run the wizard again, DirectPlayVoiceClient8.Connect will return DVERR_RUNSETUP, and you will not be able to initialize DirectPlay Voice.
If the user's sound card does not have full duplex capability, it can only listen to voice communications. It cannot send voice communications because the game typically holds the audio card in playback mode. To prevent problems, DirectX 8.0 does not enable switching dynamically between playback and capturing. The DirectX audio setup wizard provides feedback to the user on the duplexing capabilities of the system.
Note that there are still many computer systems in active use that do not include a full duplex sound card. Full duplex sound cards came into popular use in 1998, although at the time few of the audio card drivers had full duplex operation enabled. Customers who purchased new systems in 1999 or upgraded drivers in 1999 are more likely to have full duplex capability.