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