Methods > IO devices and system mixers > GetInputDeviceType method

Remarks

Obtains the type of a given input device and if it's a loopback device (*).

IMPORTANT NOTE ABOUT THE WINDOWS VERSION: This method is only intended for usage with Windows Vista and later versions; for Windows XP use the GetInputDeviceChannelType method.

(*) Loopback devices are recording devices, available starting from Windows Vista, that capture the mixing of all of the audio streams being rendered by a specific render device, also if audio streams are being played by third-party multimedia application like Windows Media Player: each render device always has a corresponding loopback device.

Syntax

[Visual Basic]

control.GetInputDeviceType (

nInputDevice as integer,

nDeviceType as enumCoreAudioDeviceTypes,

bIsLoopback as enumBoolean

) as enumErrorCodes

[C++]

short control.GetInputDeviceType (

short nInputDevice,

long *nDeviceType,

long *bIsLoopback

);

Parameter

Description

nInputDevice

Number representing the zero-based index of the input device

nDeviceType

Reference that, on return from the method call, will contain the type of input device.

Supported values are the following:

Mnemonic Value	Value	Meaning
DEVICE_TYPE_NETWORK_DEVICE	0	An audio endpoint device that the user accesses remotely through a network.
DEVICE_TYPE_SPEAKERS	1	A set of speakers.
DEVICE_TYPE_LINE_LEVEL	2	An audio endpoint device that sends a line-level analog signal to a line-input jack on an audio adapter or that receives a line-level analog signal from a line-output jack on the adapter.
DEVICE_TYPE_HEADPHONES	3	A set of headphones.
DEVICE_TYPE_MICROPHONE	4	A microphone.
DEVICE_TYPE_HEADSET	5	An earphone or a pair of earphones with an attached mouthpiece for two-way communication.
DEVICE_TYPE_HANDSET	6	The part of a telephone that is held in the hand and that contains a speaker and a microphone for two-way communication.
DEVICE_TYPE_DIGITAL_PASSTHROUGH	7	An audio endpoint device that connects to an audio adapter through a connector for a digital interface of unknown type that transmits non-PCM data in digital pass-through mode.
DEVICE_TYPE_SPDIF	8	An audio endpoint device that connects to an audio adapter through a Sony/Philips Digital Interface (S/PDIF) connector.
DEVICE_TYPE_HDMI	9	An audio endpoint device that connects to an audio adapter through a High-Definition Multimedia Interface (HDMI) connector or a display port.
DEVICE_TYPE_UNKNOWN	10	An audio endpoint device with unknown physical attributes.
DEVICE_TYPE_DISPLAYPORT	11	An audio endpoint device that connects to an audio adapter through a DisplayPort connector

bIsLoopback

Reference that, on return from the method call, will tell if the device is a loopback.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	The device is not a loopback (see the tutorial )
BOOL_TRUE	1	The device is a loopback

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The master volume has been changed correctly