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 列舉值。

在 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 列舉值。

GeoLocation

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

GenLocation

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

PortConnection

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

IsConnected

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

備註

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

規格需求

另請參閱

核心音訊結構

IKsJackDescription：：GetJackDescription