Copyright © 2006-2025 MultiMedia Soft

GetInputDeviceType method

Previous pageReturn to chapter overviewNext page

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]

Public Function GetInputDeviceType (

nInputDevice as integer,

ByRef nDeviceType as enumCoreAudioDeviceTypes,

ByRef bIsLoopback as enumBoolean

) as enumErrorCodes


 

[C#]

public enumErrorCodes GetInputDeviceType (

Int16 nInputDevice,

ref enumCoreAudioDeviceTypes nDeviceType,

ref bool bIsLoopback

);


 

[C++]

public: enumErrorCodes GetInputDeviceType (

Int16 nIndex,

enumCoreAudioDeviceTypes __gc *nDeviceType,

bool __gc *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

false

0

The device is not a loopback (see the tutorial )

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 method call was successful