| Namespace | Windows.Devices.Midi2.Transports.Network |
|---|---|
| Type Name | MidiNetworkClientConnectConfig |
| Type | WinRT Runtime Class |
| Implements | IMidiServiceTransportPluginConfig |
| IDL | MidiNetworkClientConnectConfig.idl |
Pass to MidiNetworkTransportManager.ConnectNetworkClientAsync.
| Constructor | Description |
|---|---|
MidiNetworkClientConnectConfig() |
Create an empty config |
| Property | Description |
|---|---|
ClientId |
The GUID which identifies this client entry, used for later disconnect and to match the entry in the configuration file |
Comment |
Optional comment written to the configuration file. Not used by the service |
CreateOnlyUmpEndpoints |
When true, only UMP endpoints are created. When false, MIDI 1.0 ports are created alongside them |
UmpEndpointName |
The UMP Endpoint Name to use for the local end of this connection |
CustomEndpointName |
What the customer chose to call the MIDI endpoint this connection creates. It is applied before the endpoint is activated, so the endpoint and its MIDI 1.0 ports are never created under the remote’s own name and renamed afterwards. Leave it empty to use the name the remote announces |
MatchCriteria |
A MidiNetworkClientMatchCriteria identifying the remote host |
Calling ConnectNetworkClientAsync with a ClientId which already exists does not create a duplicate. It re-arms the existing entry, which is how a direct connection marked Unavailable is retried.
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.
