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