ACX_JACK_DESCRIPTION構造体 (acxpin.h)

ACX_JACK_DESCRIPTION構造では、接続の種類、物理的な場所など、オーディオ ジャックの属性について説明します。

構文

typedef struct _ACX_JACK_DESCRIPTION {
  ULONG                    ChannelMapping;
  ULONG                    Color;
  ACX_JACK_CONNECTION_TYPE ConnectionType;
  ACX_JACK_GEO_LOCATION    GeoLocation;
  ACX_JACK_GEN_LOCATION    GenLocation;
  ACX_JACK_PORT_CONNECTION PortConnection;
} ACX_JACK_DESCRIPTION, *PACX_JACK_DESCRIPTION;

メンバー

ChannelMapping

オーディオ チャネルと対応するスピーカー位置のマッピングを指定します。 ChannelMapping は、KSAUDIO_SPEAKER_XXX フラグのビットマスクです (たとえば、SPEAKER_FRONT_LEFT |SPEAKER_FRONT_RIGHT)、ヘッダー ファイル Ksmedia.h で定義されています。 ChannelMapping は、アナログ レンダリング ピンの場合にのみ 0 以外にする必要があります。 キャプチャ ピンまたはデジタル レンダリング ピンの場合は、このメンバーを 0 に設定します。

Color

ジャックの色を指定します。 この色は、8 ビットの青、緑、赤の色コンポーネントを連結して形成される 32 ビットの RGB 値として表されます。 青色のコンポーネントは 8 つの最下位ビット (ビット 0 から 7) を占め、緑のコンポーネントはビット 8 から 15 を占有し、赤色のコンポーネントはビット 16 から 23 を占めます。 8 つの最上位ビットは 0 です。 ジャックの色が不明な場合、または物理コネクタに識別可能な色がない場合、このメンバーの値は黒を表す0x00000000。

ConnectionType

このジャックの物理接続の種類を指定します。 このメンバーの値は、次の表に示す EPcxConnectionType 列挙値のいずれかです。

値	コネクタの種類
eConnTypeUnknown	Unknown
eConnType3Point5mm	3.5 mm ミニジャック
eConnTypeQuarter	1/4インチジャック
eConnTypeAtapiInternal	ATAPI 内部コネクタ
eConnTypeRCA	RCA ジャック
eConnTypeOptical	光コネクタ
eConnTypeOtherDigital	汎用デジタル コネクタ
eConnTypeOtherAnalog	汎用アナログ コネクタ
eConnTypeMultichannelAnalogDIN	マルチチャンネルアナログDINコネクタ
eConnTypeXlrProfessional	XLR コネクタ
eConnTypeRR11Modem	RJ11 モデム コネクタ
eConnTypeCombination	コネクタの組み合わせ

GeoLocation

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

値	幾何学的な位置
eGeoLocRear	Rear
eGeoLocFront	Front
eGeoLocLeft	Left
eGeoLocRight	Right
eGeoLocTop	上
eGeoLocBottom	下
eGeoLocRearPanel	背面スライドオープンパネルまたはプルオープンパネル
eGeoLocRiser	ライザー カード
eGeoLocInsideMobileLid	モバイルコンピュータの内部蓋
eGeoLocDrivebay	ドライブベイ
eGeoLocHDMI	HDMI コネクタ
eGeoLocOutsideMobileLid	モバイルコンピューターの外蓋
eGeoLocATAPI	ATAPI コネクタ
eGeoLocNotApplicable	適用不可。 「解説」セクション を 参照してください。

GenLocation

ジャックの一般的な位置を指定します。 このメンバーの値は、次の表に示す EPcxGenLocation 列挙値のいずれかです。

値	一般的な場所
eGenLocPrimaryBox	プライマリ シャーシ
eGenLocInternal	プライマリ シャーシ内
eGenLocSeparate	別のシャーシ
eGenLocOther	その他の場所

PortConnection

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

値	ポート接続の種類
ePortConnJack	Jack
ePortConnIntegratedDevice	統合デバイスのスロット
ePortConnBothIntegratedAndJack	統合デバイス用のジャックとスロットの両方
ePortConnUnknown	Unknown

注釈

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

オーディオ デバイスが物理的にアクセス可能なジャックを公開しない場合、オーディオ デバイスは eGeoLocNotApplicable 値を使用して、物理ジャックがないことを Windows および Windows ベースのアプリに示します。 そのため、幾何学的な位置もありません。 たとえば、オーディオ デバイスは、アクセス可能なジャックなしでマザーボードに統合できます。

ACX の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、「 ACX バージョンの概要」を参照してください。

要件

要件	値
Header	acxpin.h

こちらもご覧ください

• acxpin.h ヘッダー