| Namespace | Windows.Devices.Midi2.Utilities.Files |
|---|---|
| Type Name | MidiFileReadResult |
| Type | WinRT Runtime Class |
| IDL | MidiFileReadResult.idl |
MidiFileReadResult is what every read method on MidiStandardFileReader returns. Check Succeeded before reading Sequence.
| Property | Description |
|---|---|
Succeeded |
True when the file produced a usable sequence |
Status |
The MidiFileReadStatus describing what happened |
Truncated |
True when the file ran out, or stopped making sense, before it said it would. What was read is still in the sequence, and it still plays |
Sequence |
The MidiSequence that was read. Null unless Succeeded is true |
DeclaredTrackCount |
How many tracks the file header said it had |
ReadTrackCount |
How many tracks were really read |
Succeeded and Truncated can both be true at the same time. That’s the usual case for a damaged file. A truncated file is still worth playing, so it’s reported, not treated as a failure.
Files that claim more tracks than they have are common enough to be worth reporting, not hiding. That’s why DeclaredTrackCount and ReadTrackCount are both here. If they’re different, the file isn’t what it said it was.
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.
