The IKsControl interface is used to get, set, or query the support of properties, events, and methods. This interface is part of the Windows Driver Model kernel streaming architecture, but is also used by DirectMusic to expose properties of DirectMusic ports. To retrieve this interface, call the IDirectMusicPort::QueryInterface method with IID_IKsControl in the riid parameter.
Routing of the property item request to the port varies depending on the port implementation. No properties are supported by ports which represent DirectMusic emulation on top of the Win32 handle-based multimedia calls (midiOut and midiIn functions).
Property item requests to a port which represents a pluggable software synthesizer are answered totally in user mode. The topology of this type of port is a synthesizer (represented by an IDirectMusicSynth interface) connected to a sink node (an IDirectMusicSynthSink interface). The property request will be given first to the synthesizer node, and then to the sink node if it is not recognized by the synthesizer.
The interface has the following methods. At present, only KsProperty is supported by DirectMusic.
| IKsControl | KsProperty |
| KsEvent | |
| KsMethod |
All COM interfaces inherit the IUnknown interface methods. This interface supports the following three methods:
| IUnknown | AddRef |
| QueryInterface | |
| Release |
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dmksctrl.h.