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。 为消除 IsConnectedTRUE 值的这种双重含义产生的歧义,客户端应用程序可以调用 IKsJackDescription2::GetJackDescription2 来读取 KSJACK_DESCRIPTION2 结构的 JackCapabilities 标志。 如果此标志设置了 JACKDESC2_PRESENCE_DETECT_CAPABILITY 位,则表示终结点实际上支持插孔状态检测。 在这种情况下,IsConnected 成员的返回值可以解释为准确反映插孔插入状态。

要求

版本

适用于 Windows 7 及更高版本的 Windows 操作系统。

标头

Ksmedia.h(包括 Ksmedia.h)

另请参阅

KSJACK_DESCRIPTION

IKsJackDescription2::GetJackDescription2