KSJACK_DESCRIPTION2 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ksmedia.h
typedef struct _tagKSJACK_DESCRIPTION2 {
DWORD DeviceStateInfo;
DWORD JackCapabilities;
} KSJACK_DESCRIPTION2, *PKSJACK_DESCRIPTION2;
View the official Windows hardware development documentationNo description available.
The KSJACK_DESCRIPTION2 structure specifies the capabilities and the current state of a jack that supports jack presence detection.
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.
| Flag | Meaning |
| JACKDESC2_PRESENCE_DETECT_CAPABILITY (0x00000001) | Jack supports jack presence detection. |
| JACKDESC2_DYNAMIC_FORMAT_CHANGE_CAPABILITY (0x00000002) | Jack supports dynamic format change. |
For more information about dynamic format change, see Dynamic Format Change.
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.
| Version | Available in Windows 7 and later Windows operating systems. |
| Header | Ksmedia.h (include Ksmedia.h) |
IKsJackDescription2::GetJackDescription2