Struct CardPortInfo

pub struct CardPortInfo<'a> {
    pub name: Option<Cow<'a, str>>,
    pub description: Option<Cow<'a, str>>,
    pub priority: u32,
    pub available: PortAvailable,
    pub direction: FlagSet,
    pub proplist: Proplist,
    pub latency_offset: i64,
    pub profiles: Vec<CardProfileInfo<'a>>,
    pub availability_group: Option<Cow<'a, str>>,
    pub type: DevicePortType,
}

Stores information about a specific port of a card.

Please note that this structure can be extended as part of evolutionary API updates at any time in any new release.

Fields

name: Option<Cow<'a, str>>

Name of this port.

description: Option<Cow<'a, str>>

Description of this port.

priority: u32

The higher this value is, the more useful this port is as a default.

available: PortAvailable

Availability status of this port.

direction: FlagSet

The direction of this port.

proplist: Proplist

Property list.

latency_offset: i64

Latency offset of the port that gets added to the sink/source latency when the port is active.

profiles: Vec<CardProfileInfo<'a>>

Set of available profiles.

availability_group: Option<Cow<'a, str>>

Available on crate feature pa_v14 only.

An indentifier for the group of ports that share their availability status with each other.

This is meant especially for handling cases where one 3.5 mm connector is used for headphones, headsets and microphones, and the hardware can only tell that something was plugged in but not what exactly. In this situation the ports for all those devices share their availability status, and PulseAudio can’t tell which one is actually plugged in, and some application may ask the user what was plugged in. Such applications should get a list of all card ports and compare their availability_group fields. Ports that have the same group are those that need input from the user to determine which device was plugged in. The application should then activate the user-chosen port.

May be None, in which case the port is not part of any availability group (which is the same as having a group with only one member).

The group identifier must be treated as an opaque identifier. The string may look like an ALSA control name, but applications must not assume any such relationship. The group naming scheme can change without a warning.

type: DevicePortType

Available on crate feature pa_v14 only.

Port device type.

Implementations

impl CardPortInfo<'_>

pub fn to_owned(&self) -> CardPortInfo<'static>

Creates a copy with owned data.

Trait Implementations

impl<'a> Debug for CardPortInfo<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.