KSJACK_DESCRIPTION構造 (devicetopology.h)
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
ステレオ ジャック内の 2 つのオーディオ チャネルとスピーカー位置のマッピングを指定します。
Windows Vista では、このメンバーの値は、次の表に示す EChannelMapping 列挙値のいずれかです。
| 値 | 最初のチャネル | 2 番目のチャネル |
|---|---|---|
| ePcxChanMap_FL_FR | フロント左スピーカー | フロント右スピーカー |
| ePcxChanMap_FC_LFE | フロントセンタースピーカー | 低周波数効果スピーカー (サブウーファー) |
| ePcxChanMap_BL_BR | 左下スピーカー | 右に戻るスピーカー |
| ePcxChanMap_FLC_FRC | フロント左中央スピーカー | フロント右中央スピーカー |
| ePcxChanMap_SL_SR | サイドレフトスピーカー | サイドライトスピーカー |
| ePcxChanMap_Unknown | 不明 | Unknown |
Windows 7 では、 EChannelMapping 列挙は非推奨となりました。 このメンバーのデータ型は DWORD です。 このメンバーは、Ksmedia.h で定義されている 1 つ以上の次の値の 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
ジャックの色。 この色は、8 ビットの青、緑、赤の色コンポーネントを連結して形成される 32 ビットの RGB 値として表されます。 青色のコンポーネントは 8 つの最下位ビット (ビット 0 から 7) を占め、緑のコンポーネントはビット 8 から 15 を占有し、赤色のコンポーネントはビット 16 から 23 を占めます。 8 つの最上位ビットは 0 です。 ジャックの色が不明な場合、または物理コネクタに識別可能な色がない場合、このメンバーの値は黒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 コネクタ |
| eConnTypeRR11Modem | RJ11 モデム コネクタ |
| eConnTypeCombination | コネクタの種類の組み合わせ |
GeoLocation
ジャックの幾何学的位置。 このメンバーの値は、次の表に示す EPcxGeoLocation 列挙値のいずれかです。
| 値 | 幾何学的な位置 |
|---|---|
| eGeoLocRear | 背面取り付けパネル |
| eGeoLocFront | 前面取り付けパネル |
| eGeoLocLeft | 左取り付けパネル |
| eGeoLocRight | 右取り付けパネル |
| eGeoLocTop | トップマウントパネル |
| eGeoLocBottom | ボトムマウントパネル |
|
eGeoLocRearOPanel(Windows Vista) eGeoLocRearPanel(Windows 7) |
背面スライドオープンパネルまたはプルオープンパネル |
| eGeoLocRiser | ライザー カード |
| eGeoLocInsideMobileLid | モバイルコンピュータの内部蓋 |
| eGeoLocDrivebay | ドライブベイ |
| eGeoLocHDMI | HDMI コネクタ |
| eGeoLocOutsideMobileLid | モバイルコンピューターの外蓋 |
| eGeoLocATAPI | ATAPI コネクタ |
GenLocation
ジャックの一般的な場所。 このメンバーの値は、次の表に示す EPcxGenLocation 列挙値のいずれかです。
| 値 | 一般的な場所 |
|---|---|
| eGenLocPrimaryBox | プライマリ シャーシ |
| eGenLocInternal | プライマリ シャーシ内 |
|
eGenLocSeperate(Windows Vista) eGenLocSeparate(Windows 7) |
別のシャーシ |
| eGenLocOther | その他の場所 |
PortConnection
ジャックによって表されるポートの種類。 このメンバーの値は、次の表に示す EPxcPortConnection 列挙値のいずれかです。
| 値 | ポート接続の種類 |
|---|---|
| ePortConnJack | Jack |
| ePortConnIntegratedDevice | 統合デバイスのスロット |
| ePortConnBothIntegratedAndJack | 統合デバイス用のジャックとスロットの両方 |
| ePortConnUnknown | Unknown |
IsConnected
オーディオ アダプターがジャックのジャックプレゼンス検出をサポートしている場合、 IsConnected の値は、エンドポイント デバイスがジャックに接続されているかどうかを示します。 IsConnected が TRUE の場合、デバイスは接続されます。 FALSE の場合、ジャックは空です。 ジャックプレゼンス検出をサポートしていないデバイスの場合、このメンバーは常に TRUE です。 ジャックプレゼンス検出の詳細については、「 オーディオ エンドポイント デバイス」を参照してください。
注釈
この構造体は、DeviceTopology API の IKsJackDescription::GetJackDescription メソッドによって使用されます。 エンドポイント デバイスとオーディオ アダプター内のハードウェア デバイス間の接続の一部であるオーディオ ジャックについて説明します。 ユーザーがエンドポイント デバイスをジャックに接続するかジャックから取り外す必要がある場合、オーディオ アプリケーションは 構造体の説明情報を使用して、ユーザーがジャックを見つけるのに役立ちます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | devicetopology.h |