EndpointFormFactor Enumeration

  • Article
Previous Next

EndpointFormFactor Enumeration

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

typedef enum {
  RemoteNetworkDevice,
  Speakers,
  LineLevel,
  Headphones,
  Microphone,
  Headset,
  Handset,
  UnknownDigitalPassthrough,
  SPDIF,
  HDMI,
  UnknownFormFactor
} EndpointFormFactor;

Members

RemoteNetworkDevice

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.

HDMI

An audio endpoint device that connects to an audio adapter through a High-Definition Multimedia Interface (HDMI) connector.

UnknownFormFactor

An audio endpoint device with unknown physical attributes.

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 the following documentation:

  • The descriptions of the WAVE_FORMAT_WMA_SPDIF and WAVE_FORMAT_DOLBY_AC3_SPDIF wave-format tags in the Windows DDK documentation.
  • The white paper titled "Audio Driver Support for the WMA Pro-over-S/PDIF Format" at the Audio Device Technologies for Windows Web site.

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.

Requirements

Client: Windows Vista

Header: Include Mmdeviceapi.h

See Also

Previous Next