IKsPropertySet Interface

 
Microsoft DirectShow 9.0

IKsPropertySet Interface

The IKsPropertySet interface was originally designed as an efficient way to set and retrieve device properties on WDM drivers, using KSProxy to translate the user-mode COM method calls into the kernel-mode property sets used by WDM streaming class drivers. This interface is now also used to pass information strictly between software components.

In some cases, software components must implement either this interface, or else the IKsControl interface (documented in the DirectShow DDK). For example, if you are writing a software MPEG-2 decoder for use with the Microsoft® DVD Navigator, you must implement one of these interfaces and also support the DVD-related property sets that the Navigator will send to the decoder. Pins may support one of these interfaces to allow other pins or filters to set or retrieve their properties.

  • Note   Another interface by this name exists in the dsound.h header file. The two interfaces are not compatible. The IKsControl interface, documented in the DirectShow DDK, is now the recommended interface for passing property sets between WDM drivers and user mode components.

Methods in Vtable Order

In addition to the methods inherited from IUnknown, the interface exposes the following methods.

Method Description
Set Sets a property identified by a property set GUID and a property ID.
Get Retrieves a property identified by a property set GUID and a property ID.
QuerySupported Determines whether an object supports a specified property set.

Requirements

Header: Include Ks.h, Ksproxy.h. You must include Ks.h before Ksproxy.h.

Library: Use Strmiids.lib.

See Also


Show: