devicetopology.) h KSJACK_DESCRIPTION 結構 (

KSJACK_DESCRIPTION 結構描述音訊插孔。

語法

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

成員

ChannelMapping

指定將立體聲道中的兩個音訊通道對應至喇叭位置。

在 Windows Vista 中，此成員的值是下表所示的其中一個 EChannelMapping 列舉值。

值	第一個通道	第二個通道
ePcxChanMap_FL_FR	前端喇叭	右上喇叭
ePcxChanMap_FC_LFE	前端喇叭	低頻率效果喇叭 (subwoofer)
ePcxChanMap_BL_BR	左下喇叭	右上喇叭
ePcxChanMap_FLC_FRC	左置前喇叭	右置前喇叭
ePcxChanMap_SL_SR	側邊左喇叭	右側喇叭
ePcxChanMap_Unknown	Unknown	Unknown

 

對於具有一、三或多個通道的實體連接器，此成員的值會ePcxChanMap_Unknown。

在 Windows 7 中， EChannelMapping 列舉已被取代。 這個成員的數據類型是 DWORD。 此成員會儲存在 Ksmedia.h 中定義的一或多個下列值的 0 或位 OR 組合。

#define SPEAKER_FRONT_LEFT              0x1
#define SPEAKER_FRONT_RIGHT             0x2
#define SPEAKER_FRONT_CENTER            0x4
#define SPEAKER_LOW_FREQUENCY           0x8
#define SPEAKER_BACK_LEFT               0x10
#define SPEAKER_BACK_RIGHT              0x20
#define SPEAKER_FRONT_LEFT_OF_CENTER    0x40
#define SPEAKER_FRONT_RIGHT_OF_CENTER   0x80
#define SPEAKER_BACK_CENTER             0x100
#define SPEAKER_SIDE_LEFT               0x200
#define SPEAKER_SIDE_RIGHT              0x400
#define SPEAKER_TOP_CENTER              0x800
#define SPEAKER_TOP_FRONT_LEFT          0x1000
#define SPEAKER_TOP_FRONT_CENTER        0x2000
#define SPEAKER_TOP_FRONT_RIGHT         0x4000
#define SPEAKER_TOP_BACK_LEFT           0x8000
#define SPEAKER_TOP_BACK_CENTER         0x10000
#define SPEAKER_TOP_BACK_RIGHT          0x20000

Color

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

ConnectionType

連接類型。 這個成員的值是下表所示的其中一個 EPcxConnectionType 列舉值。

值	連接器類型
eConnTypeUnknown	Unknown
eConnTypeEighth (Windows Vista) eConnType3Point5mm (Windows 7)	1/8 英吋插孔
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	底部掛接面板
eGeoLocRearOPanel (Windows Vista) eGeoLocRearPanel (Windows 7)	重新滑動開啟或提取開啟面板
eGeoLocRiser	浮點卡
eGeoLocInsideMobileLid	行動計算機內部
eGeoLocDrive	磁碟驅動器機
eGeoLocHDMI	HDMI 連接器
eGeoLocOutsideMobileLid	行動電腦外部
eGeoLocATAPI	ATAPI 連接器

GenLocation

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

值	一般位置
eGenLocPrimaryBox	在主要底座上
eGenLocInternal	在主要底座內
eGenLocSeperate (Windows Vista) eGenLocSeparate (Windows 7)	在個別底座上
eGenLocOther	其他位置

PortConnection

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

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

IsConnected

如果音訊配接器支援插孔上的插孔存在偵測， IsConnected 的值會指出端點裝置是否插入插接器。 如果 IsConnected 為 TRUE，則會插入裝置。 如果為 FALSE，則插孔是空的。 對於不支援插孔存在偵測的裝置，此成員一律為 TRUE。 如需有關插孔存在偵測的詳細資訊，請參閱 音訊端點裝置。

備註

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

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	devicetopology.h

另請參閱

核心音訊結構

IKsJackDescription：：GetJackDescription