ISpMMSysAudio::SetLineId
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method sets the line identifier associated with the multimedia device. Mixer lines are not supported for output devices. For more information on the uses of device lines, see the Win32 multimedia mixer API (for example, mixerOpen, mixerGetId, mixerGetLineInfo, and so on.)
For input devices, SAPI will attempt to automatically identify the microphone line on the input device. On non-English versions of Windows and on a small number of English systems, it may not be possible for SAPI to automatically detect the correct microphone line. In this case no error will be detected or returned. In such cases, if speech input is not being correctly detected, the user must set the microphone input line directly through Speech properties in Control Panel, Speech Recognition tab, Audio Settings, Properties. In particular, this may be necessary to adjust the microphone input line used on devices with multiple microphone inputs such as the SoundBlaster Live Platinum as the automatically chosen line may not be the input preferred by the user.
Syntax
HRESULT SetLineId(
UINT uLineId
);
Parameters
- uLineId
[in] Identifier of the line information.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_INVALIDARG |
The specified uLineId is not supported on the current device. |
SPERR_NOT_FOUND |
The audio device must have been created from a token. |
E_NOTIMPL |
Not implemented for output devices. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |