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) |