KSPROPERTY_PIN_PROPOSEDATAFORMAT2

Clients use the KSPROPERTY_PIN_PROPOSEDATAFORMAT2 property to determine if pins instantiated by the pin factory support specific data formats.

Usage Summary Table

Remarks

KSPROPERTY_TYPE_GET is only supported if the pin has proposed formats. This function allows the audio driver to provide information about the default data format on a pin.

Specify this property using KSP_PIN, where the member specifies the relevant pin factory.

KSPROPERTY_PIN_PROPOSEDATAFORMAT2 includes a structure of type KSMULTIPLE_ITEM, specifying the proposed data formats.

The KS filter returns STATUS_SUCCESS if pins can be reset to one of the proposed data formats, or an error code otherwise.

Stream minidrivers do not need to handle this property directly; the stream class driver handles this property using stream request blocks to query for more information.

This property does not actually change the data format. Clients use KSPROPERTY_CONNECTION_DATAFORMAT to change the data format.

Requirements

See also

KSP_PIN

KSDATAFORMAT

Send comments about this topic to Microsoft

Build date: 1/22/2014