KSJACK_DESCRIPTION 構造体

  • [アーティクル]

KSJACK_DESCRIPTION 構造体は、オーディオ ジャックの物理属性を指定します。

構文

typedef struct {
  DWORD              ChannelMapping;
  DWORD              Color;
  EPcxConnectionType ConnectionType;
  EPcxGeoLocation    GeoLocation;
  EPcxGenLocation    GenLocation;
  EPxcPortConnection PortConnection;
  BOOL               IsConnected;
} KSJACK_DESCRIPTION, *PKSJACK_DESCRIPTION;

メンバー

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

Note

 Devicetopology.h はもともと、EChannelMapping 型の列挙型として ChannelMapping を定義しました。 EChannelMapping 列挙は非推奨となり、Windows Vista 以降のバージョンの Windows オペレーティング システムでは使用されなくなりました。

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

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

Value Connector type

eConnTypeUnknown

Unknown

eConnType3Point5mm

3.5 mm ミニジャック

eConnTypeQuarter

1/4 インチ ジャック

eConnTypeAtapiInternal

ATAPI 内部コネクタ

eConnTypeRCA

RCA ジャック

eConnTypeOptical

光コネクタ

eConnTypeOtherDigital

汎用デジタル コネクタ

eConnTypeOtherAnalog

汎用アナログ コネクタ

eConnTypeMultichannelAnalogDIN

マルチチャネル アナログ DIN コネクタ

eConnTypeXlrProfessional

XLR Connector

eConnTypeRJ11Modem

RJ11 モデム コネクタ

eConnTypeCombination

コネクタの組み合わせ

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

Value 幾何学的位置

eGeoLocRear

Rear

eGeoLocFront

Front

eGeoLocLeft

左

eGeoLocRight

Right

eGeoLocTop

頂部

eGeoLocBottom

下詰め

eGeoLocRearPanel

リア スライドオープン パネルまたはプルオープン パネル

eGeoLocRiser

ライザー カード

eGeoLocInsideMobileLid

モバイル コンピューターの蓋の内側

eGeoLocDrivebay

ドライブ ベイ

eGeoLocHDMI

HDMI Connector

eGeoLocOutsideMobileLid

モバイル コンピューターの蓋の外側

eGeoLocATAPI

ATAPI コネクタ

eGeoLocNotApplicable

適用不可。 「解説」セクションをご覧ください。

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

Value 一般的な位置

eGenLocPrimaryBox

プライマリ シャーシ上

eGenLocInternal

プライマリ シャーシ内

eGenLocSeparate

別のシャーシ上

eGenLocOther

その他の場所

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

Value ポート接続の種類

ePortConnJack

Jack

ePortConnIntegratedDevice

統合デバイスのスロット

ePortConnBothIntegratedAndJack

統合デバイス用のジャックとスロットの両方

ePortConnUnknown

Unknown

IsConnected
ジャックに接続されている外部デバイスがあるかどうかを示します。 オーディオ コントローラーがこのピンでジャック検出をサポートしている場合、IsConnected の値は、ジャックが特定の時点でプラグによって占有されているかどうかを正確に示す必要があります。 ジャック検出をサポートしていないデバイスでは、常にこの値を TRUE に設定する必要があります。

解説

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

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

要件

ヘッダー

 ksmedia.h (Ksmedia.h をインクルード)

関連項目

KSPROPERTY_JACK_DESCRIPTION

KSPROPERTY_JACK_DESCRIPTION2

KSPROPERTY_JACK_DESCRIPTION3