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	未知
eConnType3Point5mm	3.5 公厘迷你小袋
eConnTypeQuarter	1/4 英吋插孔
eConnTypeAtapiInternal	ATAPI 內部連接器
eConnTypeRCA	RCA 千斤頂
eConnTypeOptical	光學連接器
eConnTypeOtherDigital	一般數位連接器
eConnTypeOtherAnalog	一般模擬連接器
eConnTypeMultichannelAnalogDIN	多重通道類比 DIN 連接器
eConnTypeXlrProfessional	XLR 連接器
eConnTypeRJ11Modem	RJ11 數據機連接器連接器
eConnTypeCombination	連接器組合

GeoLocation

千斤頂的幾何位置。 此成員的值是下表所示的其中一個 EPcxGeoLocation 列舉值。

價值	幾何位置
eGeoLocRear	後
eGeoLocFront	前面
eGeoLocLeft	左
eGeoLocRight	右
eGeoLocTop	返回頁首
eGeoLocBottom	底
eGeoLocRearPanel	後投影片開啟或提取開啟面板
eGeoLocRiser	崛起卡
eGeoLocInsideMobileLid	行動計算機內部蓋
eGeoLocDrivebay	磁碟驅動器機艙
eGeoLocHDMI	HDMI 連接器
eGeoLocOutsideMobileLid	行動電腦外蓋
eGeoLocATAPI	ATAPI 連接器
eGeoLocNotApplicable	不適用。 請參閱<<備註> 一節。

GenLocation

指定插孔的一般位置。 此成員的值是下表所示 EPcxGenLocation 列舉值之一。

價值	一般位置
eGenLocPrimaryBox	在主要底座上
eGenLocInternal	主要底座內部
eGenLocSeparate	在不同的底座上
eGenLocOther	其他位置

PortConnection

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

價值	埠連線類型
ePortConnJack	千斤頂
ePortConnIntegratedDevice	整合式裝置的位置
ePortConnBothIntegratedAndJack	整合式裝置的插孔和插槽
ePortConnUnknown	未知

言論

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

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

ACX 需求

ACX 最低版本： 1.0

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

要求

要求	價值
標頭	acxpin.h

另請參閱

• acxpin.h 標頭