IKsDataTypeCompletion interface (ksproxy.h)

The IKsDataTypeCompletion interface provides a method to complete partially specified media types that are passed to the IAMStreamConfig::SetFormat method.

The IID for this interface is IID_IKsDataTypeCompletion.

Inheritance

The IKsDataTypeCompletion interface inherits from the IUnknown interface.

Methods

The IKsDataTypeCompletion interface has these methods.

 
IKsDataTypeCompletion::KsCompleteMediaType

The KsCompleteMediaType method completes a partially-specified media type that was first presented to the IAMStreamConfig::SetFormat method.

Remarks

In order to keep the proxy data type neutral, optional data type handlers can be loaded to massage the data stream as it passes to or from kernel-mode filters. You should implement a data type handler as a COM server that, at least, supports the IKsDataTypeHandler interface. The IKsDataTypeCompletion interface is optional for data type handlers. A data type handler only supports IKsDataTypeCompletion if the media format has a partially specified form.

A data type handler is typically loaded during the pin connection process, and unloaded when the connection is broken. However, a data type handler is sometimes loaded briefly for other purposes. For instance, if an application uses DirectShow's IAMStreamConfig::SetFormat method, the application possibly uses a data type handler to complete a partial media type parameter returned from IAMStreamConfig::SetFormat. For more information about IAMStreamConfig::SetFormat, see the Microsoft Windows SDK documentation.

Requirements

Requirement Value
Target Platform Windows
Header ksproxy.h (include Ksproxy.h)

See also

IKsDataTypeHandler