| Namespace | Microsoft.Windows.Devices.Midi2 |
|---|---|
| Type Name | IMidiEndpointMessageProcessingPlugin |
| Type | WinRT Explicit Interface |
| IDL | IMidiEndpointMessageProcessingPlugin.idl |
| Library | Microsoft.Windows.Devices.Midi2.dll |
This interface is implemented by any type which can be an endpoint processing plugin in the client app SDK. These plugins are used to process or manipulate messages coming from an endpoint.
Microsoft provides several plugins in the API, including the MidiVirtualEndpointDevice, the MidiChannelEndpointListener, and the MidiGroupEndpointListener. All of these types implement the IMidiEndpointMessageProcessingPlugin interface and operate in the same way.
The main part of message processing is the ProcessIncomingMessage callback.
| Property | Description |
|---|---|
Id |
Generated GUID for this plugin instance. This is needed if you want to remove the plugin from the endpoint connection |
Name |
Optional application-supplied name for this plugin instance. |
Tag |
Optional application-supplied arbitrary data to associate with this plugin instance |
IsEnabled |
True if the plugin is enabled and should participate in message processing |
| Function | Description |
|---|---|
Initialize (endpointConnection) |
Called by the endpoint connection. Perform any setup code which requires the endpoint connection pointer here. |
OnEndpointConnectionOpened() |
Callback when the endpoint connection is opened. If the plugin is added after the endpoint connection has already been opened, this is called immediately. |
ProcessIncomingMessage (args, skipFurtherListeners, skipMainMessageReceivedEvent) |
Callback for processing an incoming message. If the code sets skipFurtherListeners to true, any plugins after this one will not be called. If the code sets skipMainMessageReceivedEvent to true, the endpoint’s MessageReceived event will not be called for this message. Note: this callback is synchronous, so code in this should execute quickly and return immediately when complete. |
Cleanup() |
Called when the endpoint is tearing down |
Windows MIDI Services is an open source project with all source available on GitHub. We have a great community on Discord as well. Between GitHub and Discord, you should find the information you are looking for.
