| Current File : //proc/self/root/kunden/usr/share/doc/pulseaudio-libs-devel/html/structpa__card__port__info.html |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>PulseAudio: pa_card_port_info Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">PulseAudio
 <span id="projectnumber">15.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('structpa__card__port__info.html',''); initResizable(); });
/* @license-end */
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#pub-attribs">Data Fields</a> </div>
<div class="headertitle">
<div class="title">pa_card_port_info Struct Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>Stores information about a specific port of a card.
<a href="structpa__card__port__info.html#details">More...</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr class="memitem:addcdfc867525f6c89d1b38cf4d112afd"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#addcdfc867525f6c89d1b38cf4d112afd">name</a></td></tr>
<tr class="memdesc:addcdfc867525f6c89d1b38cf4d112afd"><td class="mdescLeft"> </td><td class="mdescRight">Name of this port. <a href="structpa__card__port__info.html#addcdfc867525f6c89d1b38cf4d112afd">More...</a><br /></td></tr>
<tr class="separator:addcdfc867525f6c89d1b38cf4d112afd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a8e5cd02a344d33383dda8d4d95aded1f"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a8e5cd02a344d33383dda8d4d95aded1f">description</a></td></tr>
<tr class="memdesc:a8e5cd02a344d33383dda8d4d95aded1f"><td class="mdescLeft"> </td><td class="mdescRight">Description of this port. <a href="structpa__card__port__info.html#a8e5cd02a344d33383dda8d4d95aded1f">More...</a><br /></td></tr>
<tr class="separator:a8e5cd02a344d33383dda8d4d95aded1f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2aa0c4013f434e13fdd7b72bafe0e027"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a2aa0c4013f434e13fdd7b72bafe0e027">priority</a></td></tr>
<tr class="memdesc:a2aa0c4013f434e13fdd7b72bafe0e027"><td class="mdescLeft"> </td><td class="mdescRight">The higher this value is, the more useful this port is as a default. <a href="structpa__card__port__info.html#a2aa0c4013f434e13fdd7b72bafe0e027">More...</a><br /></td></tr>
<tr class="separator:a2aa0c4013f434e13fdd7b72bafe0e027"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0b3a2c27829a606aeb5270206adc7c5f"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a0b3a2c27829a606aeb5270206adc7c5f">available</a></td></tr>
<tr class="memdesc:a0b3a2c27829a606aeb5270206adc7c5f"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="def_8h.html#a72f790c31bf10c1d244aa078c4cdb345" title="Port availability / jack detection status.">pa_port_available</a> enum, indicating availability status of this port. <a href="structpa__card__port__info.html#a0b3a2c27829a606aeb5270206adc7c5f">More...</a><br /></td></tr>
<tr class="separator:a0b3a2c27829a606aeb5270206adc7c5f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a0cccf1dd8451460ae61be1b8b5a20470"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a0cccf1dd8451460ae61be1b8b5a20470">direction</a></td></tr>
<tr class="memdesc:a0cccf1dd8451460ae61be1b8b5a20470"><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="def_8h.html#a6852d9da8019309fa6e776d33730156d" title="Direction bitfield - while we currently do not expose anything bidirectional, one should test against...">pa_direction</a> enum, indicating the direction of this port. <a href="structpa__card__port__info.html#a0cccf1dd8451460ae61be1b8b5a20470">More...</a><br /></td></tr>
<tr class="separator:a0cccf1dd8451460ae61be1b8b5a20470"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aba1e9019d09d35588498bab80d560a96"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#aba1e9019d09d35588498bab80d560a96">n_profiles</a></td></tr>
<tr class="memdesc:aba1e9019d09d35588498bab80d560a96"><td class="mdescLeft"> </td><td class="mdescRight">Number of entries in profile array. <a href="structpa__card__port__info.html#aba1e9019d09d35588498bab80d560a96">More...</a><br /></td></tr>
<tr class="separator:aba1e9019d09d35588498bab80d560a96"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a9dc37045580b83832ca038cd6e56667e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structpa__card__profile__info.html">pa_card_profile_info</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a9dc37045580b83832ca038cd6e56667e">profiles</a></td></tr>
<tr class="separator:a9dc37045580b83832ca038cd6e56667e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ad2491777289c514eaddfc66987923d20"><td class="memItemLeft" align="right" valign="top"><a class="el" href="proplist_8h.html#acdf756a6014b6fae3b358b2c934c3426">pa_proplist</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#ad2491777289c514eaddfc66987923d20">proplist</a></td></tr>
<tr class="memdesc:ad2491777289c514eaddfc66987923d20"><td class="mdescLeft"> </td><td class="mdescRight">Property list. <a href="structpa__card__port__info.html#ad2491777289c514eaddfc66987923d20">More...</a><br /></td></tr>
<tr class="separator:ad2491777289c514eaddfc66987923d20"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3ebe9050dc7f080f8b51306462cb96fa"><td class="memItemLeft" align="right" valign="top">int64_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a3ebe9050dc7f080f8b51306462cb96fa">latency_offset</a></td></tr>
<tr class="memdesc:a3ebe9050dc7f080f8b51306462cb96fa"><td class="mdescLeft"> </td><td class="mdescRight">Latency offset of the port that gets added to the sink/source latency when the port is active. <a href="structpa__card__port__info.html#a3ebe9050dc7f080f8b51306462cb96fa">More...</a><br /></td></tr>
<tr class="separator:a3ebe9050dc7f080f8b51306462cb96fa"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a05e86078e0656c068360ce77f962e719"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structpa__card__profile__info2.html">pa_card_profile_info2</a> ** </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a05e86078e0656c068360ce77f962e719">profiles2</a></td></tr>
<tr class="memdesc:a05e86078e0656c068360ce77f962e719"><td class="mdescLeft"> </td><td class="mdescRight">Array of pointers to available profiles, or NULL. <a href="structpa__card__port__info.html#a05e86078e0656c068360ce77f962e719">More...</a><br /></td></tr>
<tr class="separator:a05e86078e0656c068360ce77f962e719"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa51ace5d6ba0001f3d00f04c927c2e60"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#aa51ace5d6ba0001f3d00f04c927c2e60">availability_group</a></td></tr>
<tr class="memdesc:aa51ace5d6ba0001f3d00f04c927c2e60"><td class="mdescLeft"> </td><td class="mdescRight">An indentifier for the group of ports that share their availability status with each other. <a href="structpa__card__port__info.html#aa51ace5d6ba0001f3d00f04c927c2e60">More...</a><br /></td></tr>
<tr class="separator:aa51ace5d6ba0001f3d00f04c927c2e60"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2a813c8984950ac53d29900544965d43"><td class="memItemLeft" align="right" valign="top">uint32_t </td><td class="memItemRight" valign="bottom"><a class="el" href="structpa__card__port__info.html#a2a813c8984950ac53d29900544965d43">type</a></td></tr>
<tr class="memdesc:a2a813c8984950ac53d29900544965d43"><td class="mdescLeft"> </td><td class="mdescRight">Port type, see <a class="el" href="def_8h.html#a6b86472b4fa68a20d1412a95a8ba83e6" title="Port type.">pa_device_port_type</a>. <a href="structpa__card__port__info.html#a2a813c8984950ac53d29900544965d43">More...</a><br /></td></tr>
<tr class="separator:a2a813c8984950ac53d29900544965d43"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Stores information about a specific port of a card. </p>
<p>Please note that this structure can be extended as part of evolutionary API updates at any time in any new release. </p><dl class="section since"><dt>Since</dt><dd>2.0 </dd></dl>
</div><h2 class="groupheader">Field Documentation</h2>
<a id="aa51ace5d6ba0001f3d00f04c927c2e60"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa51ace5d6ba0001f3d00f04c927c2e60">◆ </a></span>availability_group</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* pa_card_port_info::availability_group</td>
</tr>
</table>
</div><div class="memdoc">
<p>An indentifier for the group of ports that share their availability status with each other. </p>
<p>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 <code>availability_group</code> 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.</p>
<p>May be NULL, in which case the port is not part of any availability group (which is the same as having a group with only one member).</p>
<p>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.</p>
<dl class="section since"><dt>Since</dt><dd>14.0 </dd></dl>
</div>
</div>
<a id="a0b3a2c27829a606aeb5270206adc7c5f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a0b3a2c27829a606aeb5270206adc7c5f">◆ </a></span>available</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int pa_card_port_info::available</td>
</tr>
</table>
</div><div class="memdoc">
<p>A <a class="el" href="def_8h.html#a72f790c31bf10c1d244aa078c4cdb345" title="Port availability / jack detection status.">pa_port_available</a> enum, indicating availability status of this port. </p>
</div>
</div>
<a id="a8e5cd02a344d33383dda8d4d95aded1f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a8e5cd02a344d33383dda8d4d95aded1f">◆ </a></span>description</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* pa_card_port_info::description</td>
</tr>
</table>
</div><div class="memdoc">
<p>Description of this port. </p>
</div>
</div>
<a id="a0cccf1dd8451460ae61be1b8b5a20470"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a0cccf1dd8451460ae61be1b8b5a20470">◆ </a></span>direction</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int pa_card_port_info::direction</td>
</tr>
</table>
</div><div class="memdoc">
<p>A <a class="el" href="def_8h.html#a6852d9da8019309fa6e776d33730156d" title="Direction bitfield - while we currently do not expose anything bidirectional, one should test against...">pa_direction</a> enum, indicating the direction of this port. </p>
</div>
</div>
<a id="a3ebe9050dc7f080f8b51306462cb96fa"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3ebe9050dc7f080f8b51306462cb96fa">◆ </a></span>latency_offset</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int64_t pa_card_port_info::latency_offset</td>
</tr>
</table>
</div><div class="memdoc">
<p>Latency offset of the port that gets added to the sink/source latency when the port is active. </p>
<dl class="section since"><dt>Since</dt><dd>3.0 </dd></dl>
</div>
</div>
<a id="aba1e9019d09d35588498bab80d560a96"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aba1e9019d09d35588498bab80d560a96">◆ </a></span>n_profiles</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_card_port_info::n_profiles</td>
</tr>
</table>
</div><div class="memdoc">
<p>Number of entries in profile array. </p>
</div>
</div>
<a id="addcdfc867525f6c89d1b38cf4d112afd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#addcdfc867525f6c89d1b38cf4d112afd">◆ </a></span>name</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* pa_card_port_info::name</td>
</tr>
</table>
</div><div class="memdoc">
<p>Name of this port. </p>
</div>
</div>
<a id="a2aa0c4013f434e13fdd7b72bafe0e027"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2aa0c4013f434e13fdd7b72bafe0e027">◆ </a></span>priority</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_card_port_info::priority</td>
</tr>
</table>
</div><div class="memdoc">
<p>The higher this value is, the more useful this port is as a default. </p>
</div>
</div>
<a id="a9dc37045580b83832ca038cd6e56667e"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9dc37045580b83832ca038cd6e56667e">◆ </a></span>profiles</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structpa__card__profile__info.html">pa_card_profile_info</a>** pa_card_port_info::profiles</td>
</tr>
</table>
</div><div class="memdoc">
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000002">Deprecated:</a></b></dt><dd>Superseded by profiles2 </dd></dl>
</div>
</div>
<a id="a05e86078e0656c068360ce77f962e719"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a05e86078e0656c068360ce77f962e719">◆ </a></span>profiles2</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structpa__card__profile__info2.html">pa_card_profile_info2</a>** pa_card_port_info::profiles2</td>
</tr>
</table>
</div><div class="memdoc">
<p>Array of pointers to available profiles, or NULL. </p>
<p>Array is terminated by an entry set to NULL. </p><dl class="section since"><dt>Since</dt><dd>5.0 </dd></dl>
</div>
</div>
<a id="ad2491777289c514eaddfc66987923d20"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ad2491777289c514eaddfc66987923d20">◆ </a></span>proplist</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="proplist_8h.html#acdf756a6014b6fae3b358b2c934c3426">pa_proplist</a>* pa_card_port_info::proplist</td>
</tr>
</table>
</div><div class="memdoc">
<p>Property list. </p>
</div>
</div>
<a id="a2a813c8984950ac53d29900544965d43"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2a813c8984950ac53d29900544965d43">◆ </a></span>type</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">uint32_t pa_card_port_info::type</td>
</tr>
</table>
</div><div class="memdoc">
<p>Port type, see <a class="el" href="def_8h.html#a6b86472b4fa68a20d1412a95a8ba83e6" title="Port type.">pa_device_port_type</a>. </p>
<dl class="section since"><dt>Since</dt><dd>14.0 </dd></dl>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="introspect_8h_source.html">introspect.h</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="structpa__card__port__info.html">pa_card_port_info</a></li>
<li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1 </li>
</ul>
</div>
</body>
</html>