Share via


ISpMMSysAudio::GetLineId (Windows Embedded CE 6.0)

1/6/2010

This method gets the current line identifier that is 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; 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 GetLineId(
  UINT* puLineId
);

Parameters

  • puLineId
    [out] Pointer to line identifier information.

Return Value

The following table shows the possible return values.

Value Description

S_OK

Function completed successfully.

E_NOTIMPL

Not implemented for output devices.

E_POINTER

puLineId is invalid.

SPERR_NOT_FOUND

The audio device must have been created from a token.

FAILED(hr)

Appropriate error message.

Requirements

Header sapi.h, sapi.idl
Library sapilib.lib
Windows Embedded CE Windows CE .NET 4.1 and later

See Also

Reference

ISpMMSysAudio
SAPI Interfaces