| Namespace | Windows.Devices.Midi2.Transports.Rtp |
|---|---|
| Type Name | MidiRtpClientMatchCriteria |
| Type | WinRT Runtime Class |
| IDL | MidiRtpClientMatchCriteria.idl |
Holds either the name a remote device advertises, or its address and port. Used by MidiRtpClientConnectConfig.MatchCriteria. Set one or the other, not both.
| Constructor | Description |
|---|---|
MidiRtpClientMatchCriteria() |
Creates empty criteria, with DirectPort set to 5004 |
| Property | Description |
|---|---|
ServiceInstanceName |
The name the remote device advertises, from MidiRtpAdvertisedHost.ServiceInstanceName. The device is found again by this name when its address changes |
DirectHostNameOrIPAddress |
An IPv4 or IPv6 address, or a host name that’s looked up each time the client connects, for a direct connection |
DirectPort |
The remote device’s port, for a direct connection. RTP-MIDI also uses the port after it. 5004 unless you change it |
Your choice decides what the service does when the remote device can’t be found. The service keeps looking for an advertised name, and connects as soon as the device is advertised. A direct address is looked up again every 15 seconds. See the namespace overview for the full table.
Use the advertised name when you can. A device’s address can change, for example when a router hands out addresses, but its advertised name usually stays the same.
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.
