KSJACK_DESCRIPTION2 構造体

  • [アーティクル]

KSJACK_DESCRIPTION2 構造体は、ジャック プレゼンス検出をサポートするジャックの機能と現在の状態を指定します。

構文

typedef struct _tagKSJACK_DESCRIPTION2 {
  DWORD DeviceStateInfo;
  DWORD JackCapabilities;
} KSJACK_DESCRIPTION2, *PKSJACK_DESCRIPTION2;

メンバー

DeviceStateInfo
DWORD パラメーターの下位 16 ビットを指定します。 このパラメーターは、ジャックが現在アクティブか、ストリーミング中か、アイドル状態か、ハードウェアの準備ができていないかを示します。

JackCapabilities
DWORD パラメーターの下位 16 ビットを指定します。 このパラメーターはフラグであり、ジャックの機能を示します。 このフラグは、次のテーブルのいずれかの値に設定できます。

フラグ

意味

JACKDESC2_PRESENCE_DETECT_CAPABILITY (0x00000001)

ジャックはジャック プレゼンス検出をサポートしています。

JACKDESC2_DYNAMIC_FORMAT_CHANGE_CAPABILITY (0x00000002)

ジャックでは、動的な形式の変更がサポートされています。

動的な形式の変更の詳細については、「動的な形式の変更」をご覧ください。

解説

オーディオ デバイスにジャック プレゼンス検出がない場合、KSJACK_DESCRIPTION 構造体の IsConnected メンバーは常に TRUE に設定する必要があります。 IsConnected の TRUE 値のこの二重の意味から生じるあいまいさを削除するために、クライアント アプリケーションは IKsJackDescription2::GetJackDescription2 を呼び出して KSJACK_DESCRIPTION2 構造体の JackCapabilities フラグを読み取ることができます。 このフラグに JACKDESC2_PRESENCE_DETECT_CAPABILITY ビットが設定されている場合は、エンドポイントが実際にジャック プレゼンス検出をサポートしていることを示します。 その場合、IsConnected メンバーの戻り値を解釈して、ジャックの挿入状態を正確に反映できます。

要件

バージョン

Windows 7 以降の Windows オペレーティング システムで使用できます。

ヘッダー

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

関連項目

KSJACK_DESCRIPTION

IKsJackDescription2::GetJackDescription2