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) |
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 |