HRESULT Wizard(HWND hWndParent,
DWORD dwUse,
DWORD dwWaveInDevice,
DWORD dwSamplesPerSec,
DWORD dwFlags);
Brings up the Microphone Setup Wizard. The function returns after the Microphone Setup Wizard had completed.
hWndParent
[in] Parent window to create the wizard off of.
dwUse
[in] What the microphone wizard is intended to be used for. This may change some of the user interface.
Value | Meaning |
STMWU_CNC | The wizard is setting the system up for command and control. It will be less strict about audio record quality. |
STMWU_DICTATION | The wizard is setting the system up for dictation and will be strict about sound quality. |
dwWaveInDevice
[in] Wave-In device to use for recording and to adjust. The application can use WAVE_MAPPER if it doesn't care. If the application uses WAVE_MAPPER and there is more than one sound device, the microphone setup wizard will ask the user which sound device to use. The user's choice can be obtained from ISTMicWizard::InfoGet.
dwSamplesPerSec
[in] Sampling rate that the Microphone Setup Wizard should listen for. If the sampling rate cannot be obtained then it will error out. If an application does not know which sampling rate to use then it should set 16000.
dwFlags
[in] One or more of the following values or-ed together.
Value | Meaning |
STMWF_CANSKIP | If the microphone setup wizard has already been run by the user then just return success. An application can run ISTMicWizard->Wizard() every time it starts, using STMWF_CANSKIP, so that the user is guaranteed to have setup the microphone. |
· Returns NOERROR if successful, or one of these error values:
E_INVALIDARG
E_FAIL - The user doesn't have any sound card that can record the audio.