HRESULT MicrophoneGet(TCHAR *pszMicrophone, DWORD dwMicrophoneSize,
DWORD *pdwNeeded);
Retrieves the name of the current microphone for this audio source.
· Returns NOERROR if successful, or one of these error values:
E_INVALIDARG
E_OUTOFMEMORY
SRERR_NOTSUPPORTED
SRERR_VALUEOUTOFRANGE
pszMicrophone
[in/out] Address of a buffer that receives the name of the current microphone for an audio source. If the buffer receives an empty string, the current microphone is unknown.
dwMicrophoneSize
[in] Size, in bytes, of the buffer specified by pszMicrophone. If the specified size is too small, the function returns an error and fills pdwNeeded with the number of bytes needed.
pdwNeeded
[out] Address of a variable that receives the number of bytes needed for the microphone string.
An application can use the microphone name to save or retrieve information about a particular microphone, such as the name of the microphone used to train the engine or the conditions in which the microphone is recording. For example, an application could use this information to preserve the original training when the user changes microphones.