KSJACK_DESCRIPTION2 structure

The KSJACK_DESCRIPTION2 structure specifies the capabilities and the current state of a jack that supports jack presence detection.

Syntax

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

Members

DeviceStateInfo
Specifies the lower 16 bits of the DWORD parameter. This parameter indicates whether the jack is currently active, streaming, idle, or hardware not ready.

JackCapabilities
Specifies the lower 16 bits of the DWORD parameter. This parameter is a flag and it indicates the capabilities of the jack. This flag can be set to one of the values in the following table.

For more information about dynamic format change, see Dynamic Format Change.

Remarks

If an audio device lacks jack presence detection, the IsConnected member of the KSJACK_DESCRIPTION structure must always be set to TRUE. To remove the ambiguity that results from this dual meaning of the TRUE value for IsConnected, a client application can call IKsJackDescription2::GetJackDescription2 to read the JackCapabilities flag of the KSJACK_DESCRIPTION2 structure. If this flag has the JACKDESC2_PRESENCE_DETECT_CAPABILITY bit set, it indicates that the endpoint does in fact support jack presence detection. In that case, the return value of the IsConnected member can be interpreted to accurately reflect the insertion status of the jack.

Requirements

See also

KSJACK_DESCRIPTION

IKsJackDescription2::GetJackDescription2