ACX_JACK_DESCRIPTION結構 (acxpin.h)

  • 發行項

ACX_JACK_DESCRIPTION 結構描述音訊插孔的屬性，例如連線類型、實體位置等等。

語法

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

成員

ChannelMapping

指定音訊通道與對應說話者位置的對應。 ChannelMapping 是 (KSAUDIO_SPEAKER_XXX 旗標的位掩碼，例如SPEAKER_FRONT_LEFT |SPEAKER_FRONT_RIGHT) ，定義於頭檔 Ksmedia.h 中。 ChannelMapping 應為非零，僅適用於類比轉譯針腳。 針對擷取釘選或數位轉譯釘選，請將此成員設定為 0。

Color

指定插孔色彩。 色彩會以 32 位 RGB 值表示，其形成方式是串連 8 位藍色、綠色和紅色色彩元件。 藍色元件佔用 8 個最小有效位 (位 0-7) ，綠色元件佔用位 8-15，而紅色元件佔用位 16-23。 8 個最重要的位是零。 如果插接器色彩未知，或實體連接器沒有可識別的色彩，則此成員的值會0x00000000，代表黑色。

ConnectionType

指定這個插孔的實體連接類型。 這個成員的值是下表所示的其中一個 EPcxConnectionType 列舉值。

值 連接器類型
eConnTypeUnknown Unknown
eConnType3Point5mm 3.5 公厘迷你堆疊
eConnTypeQuarter 1/4 英吋插孔
eConnTypeAtapiInternal ATAPI 內部連接器
eConnTypeRCA RCA 插孔
eConnTypeOptical 光學連接器
eConnTypeOtherDigital 一般數位連接器
eConnTypeOtherAnalog 一般模擬連接器
eConnTypeMultichannelAnalogDIN 多重通道類比 DIN 連接器
eConnTypeXlrProfessional XLR 連接器
eConnTypeRJ11Modem RJ11 數據機連接器連接器
eConnTypeCombination 連接器組合

GeoLocation

插孔的幾何位置。 這個成員的值是下表所示的其中一個 EPcxGeoLocation 列舉值。

值 幾何位置
eGeoLocRear Rear
eGeoLocFront Front
eGeoLocLeft Left
eGeoLocRight Right
eGeoLocTop 頂端
eGeoLocBottom 下層
eGeoLocRearPanel 後投影片開啟或提取開啟面板
eGeoLocRiser 增加卡
eGeoLocInsideMobileLid 行動計算機內部
eGeoLocDrive其 磁碟驅動器機機號
eGeoLocHDMI HDMI 連接器
eGeoLocOutsideMobileLid 行動電腦外部的蓋子
eGeoLocATAPI ATAPI 連接器
eGeoLocNotApplicable 不適用。 請參閱一節。

GenLocation

指定插孔的一般位置。 這個成員的值是下表所示的其中一個 EPcxGenLocation 列舉值。

值 一般位置
eGenLocPrimaryBox 在主要底座上
eGenLocInternal 在主要底座內
eGenLocSeparate 在個別底座上
eGenLocOther 其他位置

PortConnection

指定由插孔表示的埠類型。 這個成員的值是下表所示的其中一個 EPxcPortConnection 列舉值。

值 埠連線類型
ePortConnJack 傑克
ePortConnIntegratedDevice 整合式裝置的位置
ePortConnBothIntegratedAndJack 整合式裝置的插孔和插槽
ePortConnUnknown Unknown

備註

此結構描述屬於端點裝置與音訊配接器中硬體裝置之間連線的音訊插孔。 當使用者需要將端點裝置插入到插孔或從插孔中卸載時，音訊應用程式可以使用 結構中的描述性資訊來協助使用者尋找插孔。

當音訊裝置未公開可實際存取的插孔時，音訊裝置會使用 eGeoLocNotApplicable 值向 Windows 和 Windows 應用程式指出沒有實體插接器。 因此，沒有任何幾何位置。 例如，音訊裝置可以整合到主機板中，而不需要任何可存取的插孔。

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求 值
標頭 acxpin.h

另請參閱