KSPROPERTY_JACK_DESCRIPTION

The KSPROPERTY_JACK_DESCRIPTION property is implemented as a multi-item, pin-wise property that is accessed through the filter handle.

In Windows Vista and later, this property can be supported on any bridge pin that is associated with one or more physical jacks. It is used to get a description of the physical characteristics and usage of a particular jack.

Usage Summary Table

Get	Set	Target	Property descriptor type	Property value type
Yes	No	Pin factory (via Filter handle)	KSP_PIN	KSMULTIPLE_ITEM followed by an array of KSJACK_DESCRIPTION structures

The property value (instance data) is a KSMULTIPLE_ITEM, followed by an array of KSJACK_DESCRIPTION structures.

Return Value

A KSPROPERTY_JACK_DESCRIPTION property request returns a KSMULTIPLE_ITEM followed by an array of N KSJACK_DESCRIPTION structures, where N = the number of jacks associated with the specified bridge pin. The members returned by the property request would thus be:

KSMULTIPLE_ITEM.Size = sizeof(KSMULTIPLE_ITEM) + N * sizeof(KSJACK_DESCRIPTION)

KSMULTIPLE_ITEM.Count = N

KSJACK_DESCRIPTION[0]

...

KSJACK_DESCRIPTION[N-1]

Remarks

Each KSJACK_DESCRIPTION structure must have information about one jack. For example, an output bridge pin that supports 5.1 audio over three stereo jacks, would require a data buffer of size

sizeof(KSMULTIPLE_ITEM) + 3 * sizeof(KSJACK_DESCRIPTION)

and each KSJACK_DESCRIPTION structure would have a two-bit ChannelMapping value.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2003
Header	Ksmedia.h

See also

KSJACK_DESCRIPTION

KSMULTIPLE_ITEM

KSPROPERTY