Edit

Share via

EndpointFormFactor enumeration (mmdeviceapi.h)

  • Article

The EndpointFormFactor enumeration defines constants that indicate the general physical attributes of an audio endpoint device.

Syntax

typedef enum __MIDL___MIDL_itf_mmdeviceapi_0000_0000_0003 {
  RemoteNetworkDevice = 0,
  Speakers,
  LineLevel,
  Headphones,
  Microphone,
  Headset,
  Handset,
  UnknownDigitalPassthrough,
  SPDIF,
  DigitalAudioDisplayDevice,
  UnknownFormFactor,
  EndpointFormFactor_enum_count
} EndpointFormFactor;

Constants

 
RemoteNetworkDevice
Value: 0
An audio endpoint device that the user accesses remotely through a network.
Speakers
A set of speakers.
LineLevel
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.
Headphones
A set of headphones.
Microphone
A microphone.
Headset
An earphone or a pair of earphones with an attached mouthpiece for two-way communication.
Handset
The part of a telephone that is held in the hand and that contains a speaker and a microphone for two-way communication.
UnknownDigitalPassthrough
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. For more information, see Remarks.
SPDIF
An audio endpoint device that connects to an audio adapter through a Sony/Philips Digital Interface (S/PDIF) connector.
DigitalAudioDisplayDevice
An audio endpoint device that connects to an audio adapter through a High-Definition Multimedia Interface (HDMI) connector or a display port.

In Windows Vista, this value was named HDMI.
UnknownFormFactor
An audio endpoint device with unknown physical attributes.
EndpointFormFactor_enum_count
Windows 7: Maximum number of endpoint form factors.

Remarks

The constants in this enumeration are the values that can be assigned to the PKEY_AudioEndpoint_FormFactor property.

In digital pass-through mode, a digital interface transports blocks of non-PCM data through a connection without modifying them and without attempting to interpret their contents. For more information about digital pass-through mode, see S/PDIF Pass-Through Transmission of Non-PCM Streams.

For information about obtaining a description of the audio jack or connector through which an audio endpoint device connects to an audio adapter, see IKsJackDescription::GetJackDescription and IKsJackDescription2::GetJackDescription2.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header mmdeviceapi.h

See also

Core Audio Enumerations

IKsJackDescription::GetJackDescription

PKEY_AudioEndpoint_FormFactor Property