KSJACK_DESCRIPTION結構

KSJACK_DESCRIPTION 結構會指定音訊插孔的實體屬性。

語法

typedef struct {
  DWORD              ChannelMapping;
  DWORD              Color;
  EPcxConnectionType ConnectionType;
  EPcxGeoLocation    GeoLocation;
  EPcxGenLocation    GenLocation;
  EPxcPortConnection PortConnection;
  BOOL               IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;

成員

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

注意

 Devicetopology.h 原本將 ChannelMapping 定義為 EChannelMapping 類型的列舉。 EChannelMapping 列舉自已被取代，且不再用於 Windows Vista 和更新版本的 Windows 操作系統。

色彩
指定插孔色彩。 色彩會以 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	連接器組合

地理位置
插孔的幾何位置。 這個成員的值是下表所示的其中一個 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

IsConnected
指出是否有外部裝置連線到插接器。 如果音訊控制器支援此針腳上的插接偵測， IsConnected 的值應該正確指出插接是否在任何指定時間被外掛程式佔用。 對於不支援插機偵測的裝置，此值應該一律設定為 TRUE 。

備註

這個結構是由 Windows Vista 和更新版本中 的 KSPROPERTY_JACK_DESCRIPTION 屬性使用。 它會描述屬於端點裝置與音訊配接器中硬體裝置之間的連線的音訊插接器。 當使用者需要將端點裝置插入插接器或從插孔中將其卸除時，音訊應用程式可以使用 結構中的描述性資訊來協助使用者尋找插接器。

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

規格需求

標頭	Ksmedia.h (包含 Ksmedia.h)

另請參閱

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3