次の方法で共有

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

こちらもご覧ください