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 列挙値のいずれかです。

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 列挙値のいずれかです。

GeoLocation

ジャックの幾何学的位置。 このメンバーの値は、次の表に示す EPcxGeoLocation 列挙値のいずれかです。

GenLocation

ジャックの一般的な場所。 このメンバーの値は、次の表に示す EPcxGenLocation 列挙値のいずれかです。

PortConnection

ジャックによって表されるポートの種類。 このメンバーの値は、次の表に示す EPxcPortConnection 列挙値のいずれかです。

IsConnected

オーディオ アダプターがジャックのジャックプレゼンス検出をサポートしている場合、 IsConnected の値は、エンドポイント デバイスがジャックに接続されているかどうかを示します。 IsConnected が TRUE の場合、デバイスは接続されます。 FALSE の場合、ジャックは空です。 ジャックプレゼンス検出をサポートしていないデバイスの場合、このメンバーは常に TRUE です。 ジャックプレゼンス検出の詳細については、「 オーディオ エンドポイント デバイス」を参照してください。

注釈

この構造体は、DeviceTopology API の IKsJackDescription::GetJackDescription メソッドによって使用されます。 エンドポイント デバイスとオーディオ アダプター内のハードウェア デバイス間の接続の一部であるオーディオ ジャックについて説明します。 ユーザーがエンドポイント デバイスをジャックに接続するかジャックから取り外す必要がある場合、オーディオ アプリケーションは 構造体の説明情報を使用して、ユーザーがジャックを見つけるのに役立ちます。

要件

こちらもご覧ください

コア オーディオ構造

IKsJackDescription::GetJackDescription