Share via

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
 

1 つ、3 つ、または複数のチャネルを持つ物理コネクタの場合、このメンバーの値はePcxChanMap_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

こちらもご覧ください

コア オーディオ構造

IKsJackDescription::GetJackDescription