EndpointFormFactor Enumeration

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 = (RemoteNetworkDevice+1),
    LineLevel = (Speakers+1),
    Headphones = (LineLevel+1),
    Microphone = (Headphones+1),
    Headset = (Microphone+1),
    Handset = (Headset+1),
    UnknownDigitalPassthrough = (Handset+1),
    SPDIF = (UnknownDigitalPassthrough+1),
    DigitalAudioDisplayDevice = (SPDIF+1),
    UnknownFormFactor = (DigitalAudioDisplayDevice+1),
    EndpointFormFactor_enum_count = (UnknownFormFactor+1)
} EndpointFormFactor;

Remarks

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 website.

Constants

Constant	Description
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.
DigitalAudioDisplayDevice	An audio endpoint device that connects to an audio adapter through a High-Definition Multimedia Interface (HDMI) connector or a display port.
UnknownFormFactor	An audio endpoint device with unknown physical attributes.
EndpointFormFactor_enum_count	Maximum number of endpoint form factors.

Requirements

Header: Declared in mmdeviceapi.h.

Library: Use MMDevApi.lib.