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 をインクルード) |