refactor!: rename Titano to Chronos and move CI and releases to Gitea (#6)
CI / Build and test (push) Successful in 8m14s
CI / Windows tests and installer (push) Skipped
CI / YAML check (push) Successful in 7s
Release / Build, test and publish (push) Successful in 13m19s
CI / PostgreSQL 16 integration (push) Successful in 4m49s
CI / PostgreSQL 17 integration (push) Successful in 5m28s
CI / Docker image (push) Successful in 53s
Release / Server image (push) Failing after 10s

The owner renamed the product and moved the repository to the self-hosted
Gitea (https://gitea.encke-hake.ts.net/BalboSoft/Chronos) for more control,
and asked for Actions and a first automatic release with the server package
and the Windows exe (docs/requests/2026-10-23-chronos-gitea.md).

- Chronos everywhere: a byte-exact rename of contents and paths, then a
  per-language review of the forms the old name's ending had dictated.
- Gitea instead of GitHub: the update check, licence, issue and support
  links read ChronosReleasesUrl; the update check takes the highest stable
  version, offers a pre-release build its final release and reports a
  repository it cannot see as a failed check. EULA, security policy and
  Gitea issue forms live at the repository root.
- Gitea Actions for the Linux act_runner (.gitea/workflows): CI, release,
  nightly image and performance gates in the .NET SDK container with git
  checkout and the system SQLite. The release cross-compiles the Windows
  programs, checks their icon, version and DPI manifest, packs installers
  and zips, publishes the Gitea release and pushes the server image
  (REGISTRY_TOKEN). Windows-only tests run in an opt-in job on a Windows
  runner (WINDOWS_RUNNER).
- New Chronos.Tools commands: zip, gitea-release, postgres-ci (replaces the
  docker-exec script, which Gitea's service containers do not allow; the
  throw-away server runs without durability) and pe-check.
- Timed tests take their budget from TestTiming (CHRONOS_TEST_TIME_FACTOR,
  3 on the shared runner; the weekly performance gates keep theirs).

BREAKING CHANGE: programs, settings, data folders, file types, environment
variables and the Docker image use the new name; nothing is migrated from
Titano, which never had a release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
This commit was merged in pull request #6.
This commit is contained in:
Alby96andClaude Opus 5.5 authored and Alby96 committed 2026-10-23 12:45:18 +02:00
1 parent c99842cc86
commit f2b58522b9
1801 files changed
+11804 -10676

No files matched your search

@@ -0,0 +1,124 @@
using System.Runtime.InteropServices;
using Chronos.Core.Diagnostics;
using Chronos.Core.Video;
using Chronos.Core.Windows.Interop;
namespace Chronos.Core.Windows.MediaFoundation;
/// <summary>
/// H.264, HEVC and AV1 encoding through Media Foundation MFTs (BRIEF §11.3): hardware encoders (NVENC, Quick Sync,
/// AMF…) first, the Microsoft software encoder as the H.264 fallback; HEVC and AV1 are offered only with hardware.
/// Codecs without a usable encoder are absent from <see cref="Capabilities"/>.
/// </summary>
public sealed class MediaFoundationEncoderProvider : IVideoEncoderProvider
{
private const string LogCategory = MediaFoundationEncoders.LogCategory;
private const int SoftwareH264MaxWidth = 4096, SoftwareH264MaxHeight = 2304; // Microsoft H.264 encoder, level 5.2
private readonly Lazy<IReadOnlyList<EncoderCapability>> _capabilities = new(BuildCapabilities);
public string Name => "Media Foundation";
public IReadOnlyList<EncoderCapability> Capabilities => _capabilities.Value;
public bool CanEncode(EncodeSettings settings)
{
if (!SettingsSupported(settings)) return false;
foreach (var c in Capabilities)
{
if (Fits(c.Codec, c.Name, c.Hardware, c.SupportsTenBit, settings) && settings.Width <= c.MaxWidth && settings.Height <= c.MaxHeight) return true;
}
return false;
}
public IVideoEncoderSession Open(EncodeSettings settings)
{
if (!SettingsSupported(settings)) throw new NotSupportedException($"Media Foundation cannot encode {settings.Codec} {settings.Width}×{settings.Height} {settings.BitDepth}-bit");
var runtime = MediaFoundationRuntime.Acquire();
var candidates = new List<(MediaFoundationEncoderInfo Info, IMFActivate Activate)>();
try
{
foreach (var (info, activate) in MediaFoundationEncoders.Find(settings.Codec))
{
if (Fits(info.Codec, info.Name, info.IsHardware, info.SupportsTenBit, settings)) candidates.Add((info, activate));
else ComObjects.Release(activate);
}
// Named encoder first, then the preferred kind; MFTEnumEx merit order otherwise.
var ordered = candidates
.OrderByDescending(c => settings.EncoderName is not null && c.Info.Name == settings.EncoderName)
.ThenByDescending(c => c.Info.IsHardware == settings.PreferHardware)
.ToList();
Exception? failure = null;
for (var i = 0; i < ordered.Count; i++)
{
var (info, activate) = ordered[i];
try
{
var session = MediaFoundationEncoderSession.Open(settings, info, activate, runtime);
for (var j = i + 1; j < ordered.Count; j++) ComObjects.Release(ordered[j].Activate);
candidates.Clear();
return session;
}
catch (Exception ex) when (ex is COMException or NotSupportedException or InvalidCastException)
{
Log.Warning(LogCategory, $"\"{info.Name}\" could not be configured for {settings.Codec} {settings.Width}×{settings.Height}: {ex.Message}");
candidates.Remove(ordered[i]);
activate.ShutdownObject();
ComObjects.Release(activate);
failure = ex;
}
}
throw new NotSupportedException($"No Media Foundation encoder accepted {settings.Codec} {settings.Width}×{settings.Height} {settings.BitDepth}-bit", failure);
}
catch
{
foreach (var (_, activate) in candidates) ComObjects.Release(activate);
runtime.Dispose();
throw;
}
}
private static bool SettingsSupported(EncodeSettings s) =>
s.Codec is VideoCodec.H264 or VideoCodec.Hevc or VideoCodec.Av1
&& s.Width > 0 && s.Height > 0 && s.Width % 2 == 0 && s.Height % 2 == 0
&& s.FrameRate.Numerator > 0 && s.FrameRate.Denominator > 0
&& (s.BitDepth == 8 || (s.BitDepth == 10 && s.Codec != VideoCodec.H264));
/// <summary>§11.3: HEVC and AV1 only in hardware; 10-bit needs P010 input; a named encoder must match.</summary>
private static bool Fits(VideoCodec codec, string name, bool hardware, bool tenBit, EncodeSettings s) =>
codec == s.Codec
&& (hardware || codec == VideoCodec.H264)
&& (s.BitDepth == 8 || tenBit)
&& (s.EncoderName is null || s.EncoderName == name);
private static IReadOnlyList<EncoderCapability> BuildCapabilities()
{
var capabilities = new List<EncoderCapability>();
try
{
foreach (var info in MediaFoundationEncoders.Enumerate())
{
if (!info.IsHardware && info.Codec != VideoCodec.H264) continue;
var (width, height) = info.IsHardware ? (info.Codec == VideoCodec.H264 ? (4096, 4096) : (8192, 8192)) : (SoftwareH264MaxWidth, SoftwareH264MaxHeight);
capabilities.Add(new EncoderCapability(info.Codec, info.Name, info.IsHardware, width, height,
info.SupportsTenBit && info.Codec != VideoCodec.H264, VendorName(info.VendorId)));
Log.Info(LogCategory, $"{info.Codec} encoder \"{info.Name}\" ({(info.IsHardware ? "hardware" : "software")}{(info.SupportsTenBit ? ", 10-bit" : string.Empty)})");
}
}
catch (Exception ex) when (ex is COMException or DllNotFoundException or EntryPointNotFoundException or PlatformNotSupportedException)
{
Log.Warning(LogCategory, "Media Foundation encoders could not be enumerated", ex);
}
return capabilities;
}
/// <summary>Readable vendor for PCI vendor ids reported as "VEN_xxxx".</summary>
internal static string? VendorName(string? vendorId) => vendorId?.ToUpperInvariant() switch
{
null => null,
"VEN_10DE" => "NVIDIA",
"VEN_8086" => "Intel",
"VEN_1002" or "VEN_1022" => "AMD",
"VEN_5143" or "VEN_4D4F4351" => "Qualcomm",
var other => other,
};
}
@@ -0,0 +1,642 @@
using System.Runtime.InteropServices;
using System.Runtime.InteropServices.Marshalling;
using Chronos.Core.Diagnostics;
using Chronos.Core.Imaging;
using Chronos.Core.IO;
using Chronos.Core.Video;
using Chronos.Core.Video.Bitstream;
using Chronos.Core.Video.Mp4;
using Chronos.Core.Video.Yuv;
using Chronos.Core.Windows.Interop;
namespace Chronos.Core.Windows.MediaFoundation;
/// <summary>
/// One encode through a Media Foundation encoder MFT driven directly (no SinkWriter): output type first, then NV12/P010
/// input, ICodecAPI rate control/GOP/B-frames, synchronous ProcessInput/ProcessOutput or the asynchronous event loop of
/// hardware MFTs, and Annex-B/OBU output muxed by <see cref="Mp4Muxer"/> into a temporary file that
/// <see cref="Complete"/> commits. Disposing without completing deletes the partial file.
/// </summary>
public sealed class MediaFoundationEncoderSession : IVideoEncoderSession
{
private const string LogCategory = MediaFoundationEncoders.LogCategory;
private readonly EncodeSettings _settings;
private readonly IDisposable _runtime;
private readonly IMFActivate _activate;
private readonly IMFTransform _transform;
private readonly IMFMediaEventGenerator? _events;
private readonly bool _tenBit;
private readonly string _tempPath;
private readonly FileStream _file;
private readonly Mp4Muxer _muxer;
private readonly Dictionary<long, long> _ticksByHns = [];
private readonly Dictionary<long, long> _durationByTicks = [];
private readonly Queue<long> _inputStarts = new();
private bool _providesSamples;
private uint _outputBufferSize;
private int _needInput;
private bool _drained;
private long _time;
private Encoded? _pending;
private int _framesIn;
private int _framesOut;
private bool _completed;
private bool _released;
private bool _disposed;
private MediaFoundationEncoderSession(EncodeSettings settings, MediaFoundationEncoderInfo info, IMFActivate activate, IMFTransform transform, IDisposable runtime)
{
_settings = settings;
_activate = activate;
_transform = transform;
_runtime = runtime;
_tenBit = settings.BitDepth == 10;
EncoderName = info.Name;
IsHardware = info.IsHardware;
if (UnlockAsync(transform))
_events = transform as IMFMediaEventGenerator ?? throw new NotSupportedException("Asynchronous MFT without an event generator");
if (transform as ICodecAPI is { } codecApi) ApplyCodecSettings(codecApi);
SetOutputType();
SetInputType();
ReadOutputStreamInfo();
Message(MfNative.MessageNotifyBeginStreaming);
Message(MfNative.MessageNotifyStartOfStream);
_tempPath = AtomicFile.TempPathFor(settings.OutputPath);
_file = new FileStream(_tempPath, FileMode.CreateNew, FileAccess.ReadWrite, FileShare.None, 1 << 20);
try
{
_muxer = new Mp4Muxer(_file, new VideoTrackConfig { Codec = settings.Codec, Width = settings.Width, Height = settings.Height, FastStart = true });
ReadSequenceHeader();
}
catch
{
_file.Dispose();
File.Delete(_tempPath);
throw;
}
Log.Info(LogCategory, $"Encoding {settings.Codec} {settings.Width}×{settings.Height} {settings.BitDepth}-bit with \"{info.Name}\" ({(info.IsHardware ? "hardware" : "software")}, {(_events is null ? "sync" : "async")})");
}
public string EncoderName { get; }
public bool IsHardware { get; }
/// <summary>Activates the MFT behind <paramref name="activate"/> and configures it; the session then owns the activate and the runtime lease.</summary>
internal static MediaFoundationEncoderSession Open(EncodeSettings settings, MediaFoundationEncoderInfo info, IMFActivate activate, IDisposable runtime)
{
ComObjects.Check(activate.ActivateObject(MfGuids.IidTransform, out var pointer), "IMFActivate.ActivateObject");
var transform = ComObjects.Attach<IMFTransform>(pointer);
try
{
return new MediaFoundationEncoderSession(settings, info, activate, transform, runtime);
}
catch
{
ComObjects.Release(transform);
throw;
}
}
public void WriteFrame(ImageBuffer frame, long duration90k)
{
Interop.Win32Com.EnsureInitialized();
ObjectDisposedException.ThrowIf(_disposed, this);
if (_completed) throw new InvalidOperationException("The session is complete");
if (frame.Width != _settings.Width || frame.Height != _settings.Height) throw new ArgumentException("Frame size differs from the encode size", nameof(frame));
ArgumentOutOfRangeException.ThrowIfNegativeOrZero(duration90k);
var start = _time;
_time += duration90k;
var hns = ToHns(start);
_ticksByHns[hns] = start;
_durationByTicks[start] = duration90k;
_inputStarts.Enqueue(start);
var sample = CreateInputSample(frame, hns, ToHns(_time) - hns);
try
{
if (_events is not null)
{
Pump(() => _needInput > 0);
_needInput--;
ComObjects.Check(_transform.ProcessInput(0, sample, 0), "ProcessInput");
}
else
{
SubmitSync(sample);
}
}
finally
{
ComObjects.Release(sample);
}
_framesIn++;
}
public void Complete()
{
Interop.Win32Com.EnsureInitialized();
ObjectDisposedException.ThrowIf(_disposed, this);
if (_completed) throw new InvalidOperationException("The session is already complete");
if (_framesIn == 0) throw new InvalidOperationException("No frames were written");
Message(MfNative.MessageNotifyEndOfStream);
Message(MfNative.MessageCommandDrain);
if (_events is not null) Pump(() => _drained);
else while (ProcessOutput()) { }
if (_pending is { } last)
{
// The last decoded picture keeps the duration of its own presentation slot.
WritePending(last, _durationByTicks.GetValueOrDefault(last.Pts, 1));
_pending = null;
}
Message(MfNative.MessageNotifyEndStreaming);
ReleaseEncoder();
_muxer.Complete();
_file.Flush(flushToDisk: true);
_file.Dispose();
AtomicFile.Commit(_tempPath, _settings.OutputPath);
_completed = true;
Log.Info(LogCategory, $"\"{EncoderName}\" encoded {_framesIn} frames into {_framesOut} samples: {_settings.OutputPath}");
}
public void Dispose()
{
if (_disposed) return;
_disposed = true;
if (!_completed)
{
_file.Dispose();
try
{
File.Delete(_tempPath);
}
catch (IOException ex)
{
Log.Warning(LogCategory, "Could not delete the partial output " + _tempPath, ex);
}
}
ReleaseEncoder();
_runtime.Dispose();
}
private sealed record Encoded(byte[] Data, long Pts, long Dts, bool Key);
private static bool UnlockAsync(IMFTransform transform)
{
if (transform.GetAttributes(out var pointer) < 0 || pointer == 0) return false;
var attributes = ComObjects.Attach<IMFAttributes>(pointer);
try
{
if (attributes.GetUINT32(MfGuids.TransformAsync, out var isAsync) < 0 || isAsync == 0) return false;
ComObjects.Check(attributes.SetUINT32(MfGuids.TransformAsyncUnlock, 1), "MF_TRANSFORM_ASYNC_UNLOCK");
return true;
}
finally
{
ComObjects.Release(attributes);
}
}
private void ApplyCodecSettings(ICodecAPI api)
{
var mode = _settings.RateControl switch
{
RateControl.Cbr => MfNative.RateControlCbr,
RateControl.Quality => MfNative.RateControlQuality,
_ => MfNative.RateControlUnconstrainedVbr,
};
SetCodecValue(api, MfGuids.CodecRateControlMode, ComVariant.Create(mode), "RateControlMode");
if (_settings.RateControl == RateControl.Quality)
SetCodecValue(api, MfGuids.CodecQuality, ComVariant.Create((uint)Math.Clamp(_settings.Quality, 1, 100)), "Quality");
else
SetCodecValue(api, MfGuids.CodecMeanBitRate, ComVariant.Create(BitRate), "MeanBitRate");
var gop = _settings.GopLength > 0 ? _settings.GopLength : (int)Math.Max(1, Math.Round(_settings.FrameRate.Value));
SetCodecValue(api, MfGuids.CodecGopSize, ComVariant.Create((uint)gop), "GOPSize");
var bFrames = _settings.Profile == CodecProfile.H264Baseline ? 0 : Math.Max(0, _settings.BFrames);
SetCodecValue(api, MfGuids.CodecBPictureCount, ComVariant.Create((uint)bFrames), "BPictureCount");
SetCodecValue(api, MfGuids.CodecLowLatencyMode, ComVariant.Create(false), "LowLatencyMode");
}
private static unsafe void SetCodecValue(ICodecAPI api, in Guid property, ComVariant value, string name)
{
if (api.IsSupported(property) != 0)
{
Log.Debug(LogCategory, $"ICodecAPI {name} not supported by the encoder");
return;
}
var hr = api.SetValue(property, (nint)(&value));
if (hr < 0) Log.Debug(LogCategory, $"ICodecAPI {name} rejected (0x{hr:X8})");
}
/// <summary>Requested bit rate, or the preset density (§11.4: 0.10/0.07/0.05 bits per pixel per frame) when unset.</summary>
private uint BitRate
{
get
{
if (_settings.BitRate > 0) return (uint)Math.Min(uint.MaxValue, _settings.BitRate);
var bpp = _settings.Codec switch { VideoCodec.H264 => 0.10, VideoCodec.Hevc => 0.07, _ => 0.05 };
return (uint)Math.Min(uint.MaxValue, _settings.Width * (double)_settings.Height * _settings.FrameRate.Value * bpp);
}
}
private void SetOutputType()
{
var level = CodecLimits.Check(_settings.Codec, _settings.Width, _settings.Height, _settings.FrameRate.Value, BitRate, _settings.Profile).Level;
var hr = TrySetOutputType(level);
if (hr < 0 && level is not null)
{
Log.Debug(LogCategory, $"Output type with level {level} rejected (0x{hr:X8}); letting the encoder choose");
hr = TrySetOutputType(null);
}
ComObjects.Check(hr, "SetOutputType");
}
private int TrySetOutputType(CodecLevel? level)
{
var type = CreateMediaType();
try
{
ComObjects.Check(type.SetGUID(MfGuids.Subtype, MediaFoundationEncoders.Subtype(_settings.Codec)), "MF_MT_SUBTYPE");
ComObjects.Check(type.SetUINT32(MfGuids.AverageBitrate, BitRate), "MF_MT_AVG_BITRATE");
SetVideoFormat(type);
var profile = Profile();
if (profile > 0) ComObjects.Check(type.SetUINT32(MfGuids.Mpeg2Profile, profile), "MF_MT_MPEG2_PROFILE");
if (level is { } l && _settings.Codec != VideoCodec.Av1)
{
var idc = _settings.Codec == VideoCodec.H264 ? l.H264LevelIdc : l.HevcLevelIdc;
ComObjects.Check(type.SetUINT32(MfGuids.Mpeg2Level, (uint)idc), "MF_MT_MPEG2_LEVEL");
}
return _transform.SetOutputType(0, type, 0);
}
finally
{
ComObjects.Release(type);
}
}
/// <summary>eAVEncH264VProfile / eAVEncH265VProfile value; AV1 encoders derive the profile from the input format.</summary>
private uint Profile() => _settings.Codec switch
{
VideoCodec.H264 => _settings.Profile switch
{
CodecProfile.H264Baseline => 66u,
CodecProfile.H264Main => 77u,
_ => 100u,
},
VideoCodec.Hevc => _tenBit ? 2u : 1u,
_ => 0u,
};
private void SetInputType()
{
var subtype = _tenBit ? MfGuids.FormatP010 : MfGuids.FormatNv12;
var type = CreateMediaType();
int hr;
try
{
ComObjects.Check(type.SetGUID(MfGuids.Subtype, subtype), "MF_MT_SUBTYPE");
ComObjects.Check(type.SetUINT32(MfGuids.DefaultStride, (uint)(_settings.Width * (_tenBit ? 2 : 1))), "MF_MT_DEFAULT_STRIDE");
SetVideoFormat(type);
hr = _transform.SetInputType(0, type, 0);
}
finally
{
ComObjects.Release(type);
}
// Some encoders only accept their own enumerated input types: complete one with our format.
for (uint index = 0; hr < 0; index++)
{
var available = _transform.GetInputAvailableType(0, index, out var pointer);
if (available < 0) break;
var candidate = ComObjects.Attach<IMFMediaType>(pointer);
try
{
if (candidate.GetGUID(MfGuids.Subtype, out var s) < 0 || s != subtype) continue;
SetVideoFormat(candidate);
hr = _transform.SetInputType(0, candidate, 0);
}
finally
{
ComObjects.Release(candidate);
}
}
ComObjects.Check(hr, $"SetInputType ({(_tenBit ? "P010" : "NV12")})");
}
private static IMFMediaType CreateMediaType()
{
ComObjects.Check(MfNative.MFCreateMediaType(out var pointer), "MFCreateMediaType");
var type = ComObjects.Attach<IMFMediaType>(pointer);
ComObjects.Check(type.SetGUID(MfGuids.MajorType, MfGuids.MediaTypeVideo), "MF_MT_MAJOR_TYPE");
return type;
}
/// <summary>Frame size and rate, square pixels, progressive, BT.709 limited range.</summary>
private void SetVideoFormat(IMFMediaType type)
{
ComObjects.Check(type.SetUINT64(MfGuids.FrameSize, Pack(_settings.Width, _settings.Height)), "MF_MT_FRAME_SIZE");
ComObjects.Check(type.SetUINT64(MfGuids.FrameRate, Pack(_settings.FrameRate.Numerator, _settings.FrameRate.Denominator)), "MF_MT_FRAME_RATE");
ComObjects.Check(type.SetUINT64(MfGuids.PixelAspectRatio, Pack(1, 1)), "MF_MT_PIXEL_ASPECT_RATIO");
ComObjects.Check(type.SetUINT32(MfGuids.InterlaceMode, MfNative.InterlaceProgressive), "MF_MT_INTERLACE_MODE");
type.SetUINT32(MfGuids.NominalRange, MfNative.NominalRange16To235);
type.SetUINT32(MfGuids.VideoPrimaries, MfNative.PrimariesBt709);
type.SetUINT32(MfGuids.TransferFunction, MfNative.TransferBt709);
type.SetUINT32(MfGuids.YuvMatrix, MfNative.MatrixBt709);
}
private static ulong Pack(int high, int low) => (ulong)(uint)high << 32 | (uint)low;
private void ReadOutputStreamInfo()
{
ComObjects.Check(_transform.GetOutputStreamInfo(0, out var info), "GetOutputStreamInfo");
_providesSamples = (info.Flags & (MfNative.OutputStreamProvidesSamples | MfNative.OutputStreamCanProvideSamples)) != 0;
_outputBufferSize = Math.Max(info.Size, (uint)(_settings.Width * _settings.Height * 3 / 2));
}
/// <summary>Hands MF_MT_MPEG_SEQUENCE_HEADER (parameter sets / sequence header OBU) of the current output type to the muxer.</summary>
private void ReadSequenceHeader()
{
if (_transform.GetOutputCurrentType(0, out var pointer) < 0) return;
var type = ComObjects.Attach<IMFMediaType>(pointer);
try
{
if (type.GetAllocatedBlob(MfGuids.MpegSequenceHeader, out var blob, out var size) < 0) return;
try
{
var bytes = new byte[size];
Marshal.Copy(blob, bytes, 0, (int)size);
_muxer.AddParameterSets(bytes);
}
finally
{
Marshal.FreeCoTaskMem(blob);
}
}
finally
{
ComObjects.Release(type);
}
}
private unsafe IMFSample CreateInputSample(ImageBuffer frame, long time, long duration)
{
var fourCc = _tenBit ? 0x30313050u : 0x3231564Eu; // 'P010' / 'NV12'
ComObjects.Check(MfNative.MFCreate2DMediaBuffer((uint)_settings.Width, (uint)_settings.Height, fourCc, false, out var bufferPointer), "MFCreate2DMediaBuffer");
var buffer = ComObjects.Attach<IMFMediaBuffer>(bufferPointer);
try
{
var buffer2D = buffer as IMF2DBuffer ?? throw new NotSupportedException("Media buffer without IMF2DBuffer");
ComObjects.Check(buffer2D.Lock2D(out var scanline0, out var pitch), "IMF2DBuffer.Lock2D");
try
{
if (pitch <= 0) throw new NotSupportedException("Bottom-up input buffers are not supported");
var rows = _settings.Height * 3 / 2;
if (_tenBit) Nv12Converter.ToP010(frame, new Span<ushort>((void*)scanline0, pitch / 2 * rows), ChromaSiting.Left, pitch / 2);
else Nv12Converter.ToNv12(frame, new Span<byte>((void*)scanline0, pitch * rows), ChromaSiting.Left, pitch);
}
finally
{
buffer2D.Unlock2D();
}
// 2D buffers report their contiguous size; setting it explicitly helps encoders that read the plain length.
if (buffer2D.GetContiguousLength(out var length) >= 0 && buffer.SetCurrentLength(length) < 0)
Log.Debug(LogCategory, "SetCurrentLength on the 2D input buffer was rejected");
ComObjects.Check(MfNative.MFCreateSample(out var samplePointer), "MFCreateSample");
var sample = ComObjects.Attach<IMFSample>(samplePointer);
try
{
ComObjects.Check(sample.AddBuffer(buffer), "AddBuffer");
ComObjects.Check(sample.SetSampleTime(time), "SetSampleTime");
ComObjects.Check(sample.SetSampleDuration(duration), "SetSampleDuration");
return sample;
}
catch
{
ComObjects.Release(sample);
throw;
}
}
finally
{
ComObjects.Release(buffer);
}
}
private void SubmitSync(IMFSample sample)
{
while (true)
{
var hr = _transform.ProcessInput(0, sample, 0);
if (hr != MfNative.NotAccepting)
{
ComObjects.Check(hr, "ProcessInput");
break;
}
// Full: collect output first; an encoder that neither accepts input nor yields output is stuck.
if (!ProcessOutput()) throw new COMException("Encoder refuses input without producing output", hr);
while (ProcessOutput()) { }
}
while (ProcessOutput()) { }
}
/// <summary>Runs the asynchronous MFT event loop until <paramref name="done"/> holds.</summary>
private void Pump(Func<bool> done)
{
while (!done())
{
ComObjects.Check(_events!.GetEvent(0, out var pointer), "IMFMediaEventGenerator.GetEvent");
var mediaEvent = ComObjects.Attach<IMFMediaEvent>(pointer);
uint type;
int status;
try
{
ComObjects.Check(mediaEvent.GetEventType(out type), "IMFMediaEvent.GetType");
ComObjects.Check(mediaEvent.GetStatus(out status), "IMFMediaEvent.GetStatus");
}
finally
{
ComObjects.Release(mediaEvent);
}
if (status < 0 || type == MfNative.EventError) throw new COMException($"Encoder reported event {type} with failure", status);
switch (type)
{
case MfNative.EventNeedInput:
_needInput++;
break;
case MfNative.EventHaveOutput:
ProcessOutput();
break;
case MfNative.EventDrainComplete:
_drained = true;
break;
}
}
}
/// <summary>Pulls one output sample; false when the encoder needs more input.</summary>
private bool ProcessOutput()
{
IMFSample? own = null;
nint ownPointer = 0;
var data = new MftOutputDataBuffer();
if (!_providesSamples)
{
own = CreateOutputSample();
data.Sample = ownPointer = ComObjects.GetPointer(own);
}
int hr;
try
{
hr = _transform.ProcessOutput(0, 1, ref data, out _);
}
finally
{
if (data.Events != 0) Marshal.Release(data.Events);
if (ownPointer != 0) Marshal.Release(ownPointer);
}
if (hr < 0)
{
ComObjects.Release(own);
if (hr == MfNative.TransformNeedMoreInput) return false;
if (hr == MfNative.TransformStreamChange)
{
Renegotiate();
return true;
}
ComObjects.Check(hr, "ProcessOutput");
}
var output = own ?? ComObjects.AttachOrNull<IMFSample>(data.Sample);
if (output is null) return true;
try
{
Deliver(output);
}
finally
{
ComObjects.Release(output);
}
return true;
}
private IMFSample CreateOutputSample()
{
ComObjects.Check(MfNative.MFCreateMemoryBuffer(_outputBufferSize, out var bufferPointer), "MFCreateMemoryBuffer");
var buffer = ComObjects.Attach<IMFMediaBuffer>(bufferPointer);
try
{
ComObjects.Check(MfNative.MFCreateSample(out var samplePointer), "MFCreateSample");
var sample = ComObjects.Attach<IMFSample>(samplePointer);
ComObjects.Check(sample.AddBuffer(buffer), "AddBuffer");
return sample;
}
finally
{
ComObjects.Release(buffer);
}
}
/// <summary>MF_E_TRANSFORM_STREAM_CHANGE: adopt the encoder's new output type and its sequence header.</summary>
private void Renegotiate()
{
ComObjects.Check(_transform.GetOutputAvailableType(0, 0, out var pointer), "GetOutputAvailableType");
var type = ComObjects.Attach<IMFMediaType>(pointer);
try
{
ComObjects.Check(_transform.SetOutputType(0, type, 0), "SetOutputType (stream change)");
}
finally
{
ComObjects.Release(type);
}
ReadOutputStreamInfo();
ReadSequenceHeader();
Log.Debug(LogCategory, $"\"{EncoderName}\" renegotiated its output type");
}
private void Deliver(IMFSample sample)
{
ComObjects.Check(sample.GetSampleTime(out var pts), "GetSampleTime");
bool? cleanPoint = sample.GetUINT32(MfGuids.SampleCleanPoint, out var clean) >= 0 ? clean != 0 : null;
long? dts = sample.GetUINT64(MfGuids.SampleDecodeTimestamp, out var decode) >= 0 ? (long)decode : null;
ComObjects.Check(sample.ConvertToContiguousBuffer(out var bufferPointer), "ConvertToContiguousBuffer");
var buffer = ComObjects.Attach<IMFMediaBuffer>(bufferPointer);
byte[] bytes;
try
{
ComObjects.Check(buffer.Lock(out var data, out _, out var length), "IMFMediaBuffer.Lock");
try
{
bytes = new byte[length];
Marshal.Copy(data, bytes, 0, (int)length);
}
finally
{
buffer.Unlock();
}
}
finally
{
ComObjects.Release(buffer);
}
if (bytes.Length == 0) return;
var key = cleanPoint ?? IsRandomAccess(bytes);
var ptsTicks = _ticksByHns.Remove(pts, out var exact) ? exact : To90k(pts);
// Without MFSampleExtension_DecodeTimestamp the n-th output decodes at the n-th input's time.
_inputStarts.TryDequeue(out var inputStart);
var dtsTicks = dts is { } d ? To90k(d) : inputStart;
var encoded = new Encoded(bytes, ptsTicks, dtsTicks, key);
if (_pending is { } previous) WritePending(previous, Math.Max(1, encoded.Dts - previous.Dts));
_pending = encoded;
_framesOut++;
}
/// <summary>Sync detection for encoders that do not set MFSampleExtension_CleanPoint: IDR/IRAP NAL units or an AV1 sequence header.</summary>
private bool IsRandomAccess(byte[] data)
{
if (_settings.Codec == VideoCodec.Av1)
{
foreach (var obu in Av1ObuParser.Split(data))
{
if (obu.Type == Av1ObuType.SequenceHeader) return true;
}
return false;
}
foreach (var unit in AnnexBParser.SplitAccessUnit(data, out _))
{
var header = data[unit.Offset];
if (_settings.Codec == VideoCodec.H264 ? AnnexBParser.H264Type(header) == H264NalUnitType.IdrSlice
: AnnexBParser.HevcType(header) is >= HevcNalUnitType.BlaWLp and <= HevcNalUnitType.Cra)
return true;
}
return false;
}
private void WritePending(Encoded sample, long duration)
{
_muxer.WriteSample(sample.Data, duration, sample.Key, sample.Pts - sample.Dts);
_durationByTicks.Remove(sample.Pts);
}
private void Message(uint message) => ComObjects.Check(_transform.ProcessMessage(message, 0), $"ProcessMessage(0x{message:X})");
private void ReleaseEncoder()
{
if (_released) return;
_released = true;
ComObjects.Release(_transform);
_activate.ShutdownObject();
ComObjects.Release(_activate);
}
private static long ToHns(long ticks90k) => (ticks90k * 1000 + 4) / 9;
private static long To90k(long hns) => (long)Math.Round(hns * 9 / 1000.0);
}
@@ -0,0 +1,95 @@
using System.Runtime.InteropServices;
using Chronos.Core.Diagnostics;
using Chronos.Core.Video;
using Chronos.Core.Windows.Interop;
namespace Chronos.Core.Windows.MediaFoundation;
/// <summary>A Media Foundation video encoder MFT available on this machine.</summary>
/// <param name="Name">MFT_FRIENDLY_NAME_Attribute, e.g. "NVIDIA HEVC Encoder MFT".</param>
/// <param name="VendorId">MFT_ENUM_HARDWARE_VENDOR_ID_Attribute of hardware MFTs, e.g. "VEN_10DE".</param>
/// <param name="SupportsTenBit">The MFT accepts P010 input (HEVC Main10 / AV1 10-bit).</param>
public sealed record MediaFoundationEncoderInfo(VideoCodec Codec, string Name, bool IsHardware, bool IsAsync, string? VendorId, bool SupportsTenBit);
/// <summary>Discovers H.264, HEVC and AV1 encoder MFTs with MFTEnumEx in the system's merit order (hardware first).</summary>
public static class MediaFoundationEncoders
{
internal const string LogCategory = "MediaFoundation";
private static readonly VideoCodec[] Codecs = [VideoCodec.H264, VideoCodec.Hevc, VideoCodec.Av1];
/// <summary>Every encoder MFT for H.264, HEVC and AV1; empty when Media Foundation is unavailable.</summary>
public static IReadOnlyList<MediaFoundationEncoderInfo> Enumerate()
{
if (!MediaFoundationRuntime.IsAvailable) return [];
using var lease = MediaFoundationRuntime.Acquire();
var result = new List<MediaFoundationEncoderInfo>();
foreach (var codec in Codecs)
{
foreach (var (info, activate) in Find(codec))
{
result.Add(info);
ComObjects.Release(activate);
}
}
return result;
}
/// <summary>Encoder activation objects for <paramref name="codec"/>; Media Foundation must be started and the caller releases them.</summary>
internal static List<(MediaFoundationEncoderInfo Info, IMFActivate Activate)> Find(VideoCodec codec)
{
var tenBit = new HashSet<string>(StringComparer.Ordinal);
if (codec != VideoCodec.H264)
{
foreach (var activate in Activates(codec, MfGuids.FormatP010))
{
if (FriendlyName(activate) is { } name) tenBit.Add(name);
ComObjects.Release(activate);
}
}
var found = new List<(MediaFoundationEncoderInfo, IMFActivate)>();
foreach (var activate in Activates(codec, null))
{
var name = FriendlyName(activate) ?? "Unnamed encoder";
var flags = activate.GetUINT32(MfGuids.TransformFlags, out var f) >= 0 ? f : 0;
string? vendor = null;
if (activate.GetAllocatedString(MfGuids.HardwareVendorId, out var vendorPointer, out _) >= 0) vendor = ComObjects.TakeString(vendorPointer);
var info = new MediaFoundationEncoderInfo(codec, name, (flags & MfNative.EnumHardware) != 0, (flags & MfNative.EnumAsync) != 0, vendor, tenBit.Contains(name));
found.Add((info, activate));
}
return found;
}
internal static Guid Subtype(VideoCodec codec) => codec switch
{
VideoCodec.H264 => MfGuids.FormatH264,
VideoCodec.Hevc => MfGuids.FormatHevc,
VideoCodec.Av1 => MfGuids.FormatAv1,
_ => throw new ArgumentException($"{codec} has no Media Foundation encoder", nameof(codec)),
};
private static string? FriendlyName(IMFActivate activate) =>
activate.GetAllocatedString(MfGuids.FriendlyName, out var pointer, out _) >= 0 ? ComObjects.TakeString(pointer) : null;
private static unsafe List<IMFActivate> Activates(VideoCodec codec, Guid? inputSubtype)
{
var output = new MftRegisterTypeInfo { MajorType = MfGuids.MediaTypeVideo, Subtype = Subtype(codec) };
var input = new MftRegisterTypeInfo { MajorType = MfGuids.MediaTypeVideo, Subtype = inputSubtype ?? Guid.Empty };
const uint flags = MfNative.EnumHardware | MfNative.EnumAsync | MfNative.EnumSync | MfNative.EnumSortAndFilter;
var hr = MfNative.MFTEnumEx(MfGuids.VideoEncoderCategory, flags, inputSubtype.HasValue ? &input : null, &output, out var array, out var count);
var list = new List<IMFActivate>((int)count);
if (hr < 0)
{
Log.Warning(LogCategory, $"MFTEnumEx for {codec} failed with HRESULT 0x{hr:X8}");
return list;
}
try
{
for (var i = 0; i < count; i++) list.Add(ComObjects.Attach<IMFActivate>(Marshal.ReadIntPtr(array, i * IntPtr.Size)));
}
finally
{
Marshal.FreeCoTaskMem(array);
}
return list;
}
}
@@ -0,0 +1,46 @@
using System.Runtime.InteropServices;
using Chronos.Core.Windows.Interop;
namespace Chronos.Core.Windows.MediaFoundation;
/// <summary>Reference-counted MFStartup/MFShutdown shared by every Media Foundation user in the process.</summary>
internal static class MediaFoundationRuntime
{
private static readonly Lock Gate = new();
private static int _references;
/// <summary>True when mfplat.dll can be loaded (absent on Windows "N" editions without the Media Feature Pack).</summary>
public static bool IsAvailable { get; } = OperatingSystem.IsWindows() && NativeLibrary.TryLoad("mfplat.dll", out _);
/// <summary>Starts Media Foundation for the lifetime of the returned lease.</summary>
public static IDisposable Acquire()
{
if (!IsAvailable) throw new PlatformNotSupportedException("Media Foundation is not available on this system");
// Media Foundation requires COM on the calling thread; source-generated COM does not initialise it implicitly.
Interop.Win32Com.EnsureInitialized();
lock (Gate)
{
if (_references == 0) ComObjects.Check(MfNative.MFStartup(MfNative.Version, MfNative.StartupLite), "MFStartup");
_references++;
}
return new Lease();
}
private static void Release()
{
lock (Gate)
{
if (--_references == 0) MfNative.MFShutdown();
}
}
private sealed class Lease : IDisposable
{
private int _released;
public void Dispose()
{
if (Interlocked.Exchange(ref _released, 1) == 0) Release();
}
}
}
@@ -0,0 +1,314 @@
using System.Runtime.InteropServices;
using System.Runtime.InteropServices.Marshalling;
namespace Chronos.Core.Windows.MediaFoundation;
// Media Foundation COM interfaces in vtable order (mfobjects.h, mftransform.h, strmif.h). Every method returns the raw
// HRESULT because MF uses failure codes for flow control (MF_E_TRANSFORM_NEED_MORE_INPUT, MF_E_NOTACCEPTING…).
// Interface pointers come back as nint and are wrapped with ComObjects.Attach for deterministic release; VARIANT and
// PROPVARIANT arguments are raw pointers so the assembly keeps runtime marshalling enabled.
[GeneratedComInterface]
[Guid("2cd2d921-c447-44a7-a13c-4adabfc247e3")]
internal partial interface IMFAttributes
{
[PreserveSig] int GetItem(in Guid key, nint value);
[PreserveSig] int GetItemType(in Guid key, out int type);
[PreserveSig] int CompareItem(in Guid key, nint value, out int result);
[PreserveSig] int Compare(nint theirs, int matchType, out int result);
[PreserveSig] int GetUINT32(in Guid key, out uint value);
[PreserveSig] int GetUINT64(in Guid key, out ulong value);
[PreserveSig] int GetDouble(in Guid key, out double value);
[PreserveSig] int GetGUID(in Guid key, out Guid value);
[PreserveSig] int GetStringLength(in Guid key, out uint length);
[PreserveSig] int GetString(in Guid key, nint buffer, uint bufferSize, out uint length);
[PreserveSig] int GetAllocatedString(in Guid key, out nint value, out uint length);
[PreserveSig] int GetBlobSize(in Guid key, out uint size);
[PreserveSig] int GetBlob(in Guid key, nint buffer, uint bufferSize, out uint size);
[PreserveSig] int GetAllocatedBlob(in Guid key, out nint buffer, out uint size);
[PreserveSig] int GetUnknown(in Guid key, in Guid iid, out nint value);
[PreserveSig] int SetItem(in Guid key, nint value);
[PreserveSig] int DeleteItem(in Guid key);
[PreserveSig] int DeleteAllItems();
[PreserveSig] int SetUINT32(in Guid key, uint value);
[PreserveSig] int SetUINT64(in Guid key, ulong value);
[PreserveSig] int SetDouble(in Guid key, double value);
[PreserveSig] int SetGUID(in Guid key, in Guid value);
[PreserveSig] int SetString(in Guid key, nint value);
[PreserveSig] int SetBlob(in Guid key, nint buffer, uint size);
[PreserveSig] int SetUnknown(in Guid key, nint unknown);
[PreserveSig] int LockStore();
[PreserveSig] int UnlockStore();
[PreserveSig] int GetCount(out uint count);
[PreserveSig] int GetItemByIndex(uint index, out Guid key, nint value);
[PreserveSig] int CopyAllItems(nint destination);
}
[GeneratedComInterface]
[Guid("44ae0fa8-ea31-4109-8d2e-4cae4997c555")]
internal partial interface IMFMediaType : IMFAttributes
{
[PreserveSig] int GetMajorType(out Guid type);
[PreserveSig] int IsCompressedFormat(out int compressed);
[PreserveSig] int IsEqual(nint other, out uint flags);
[PreserveSig] int GetRepresentation(Guid representation, out nint value);
[PreserveSig] int FreeRepresentation(Guid representation, nint value);
}
[GeneratedComInterface]
[Guid("045fa593-8799-42b8-bc8d-8968c6453507")]
internal partial interface IMFMediaBuffer
{
[PreserveSig] int Lock(out nint buffer, out uint maxLength, out uint currentLength);
[PreserveSig] int Unlock();
[PreserveSig] int GetCurrentLength(out uint length);
[PreserveSig] int SetCurrentLength(uint length);
[PreserveSig] int GetMaxLength(out uint length);
}
[GeneratedComInterface]
[Guid("7dc9d5f9-9ed9-44ec-9bbf-0600bb589fbb")]
internal partial interface IMF2DBuffer
{
[PreserveSig] int Lock2D(out nint scanline0, out int pitch);
[PreserveSig] int Unlock2D();
[PreserveSig] int GetScanline0AndPitch(out nint scanline0, out int pitch);
[PreserveSig] int IsContiguousFormat(out int contiguous);
[PreserveSig] int GetContiguousLength(out uint length);
[PreserveSig] int ContiguousCopyTo(nint destination, uint size);
[PreserveSig] int ContiguousCopyFrom(nint source, uint size);
}
[GeneratedComInterface]
[Guid("c40a00f2-b93a-4d80-ae8c-5a1c634f58e4")]
internal partial interface IMFSample : IMFAttributes
{
[PreserveSig] int GetSampleFlags(out uint flags);
[PreserveSig] int SetSampleFlags(uint flags);
[PreserveSig] int GetSampleTime(out long time);
[PreserveSig] int SetSampleTime(long time);
[PreserveSig] int GetSampleDuration(out long duration);
[PreserveSig] int SetSampleDuration(long duration);
[PreserveSig] int GetBufferCount(out uint count);
[PreserveSig] int GetBufferByIndex(uint index, out nint buffer);
[PreserveSig] int ConvertToContiguousBuffer(out nint buffer);
[PreserveSig] int AddBuffer(IMFMediaBuffer buffer);
[PreserveSig] int RemoveBufferByIndex(uint index);
[PreserveSig] int RemoveAllBuffers();
[PreserveSig] int GetTotalLength(out uint length);
[PreserveSig] int CopyToBuffer(IMFMediaBuffer buffer);
}
[GeneratedComInterface]
[Guid("7fee9e9a-4a89-47a6-899c-b6a53a70fb67")]
internal partial interface IMFActivate : IMFAttributes
{
[PreserveSig] int ActivateObject(in Guid iid, out nint instance);
[PreserveSig] int ShutdownObject();
[PreserveSig] int DetachObject();
}
[GeneratedComInterface]
[Guid("df598932-f10c-4e39-bba2-c308f101daa3")]
internal partial interface IMFMediaEvent : IMFAttributes
{
[PreserveSig] int GetEventType(out uint type);
[PreserveSig] int GetExtendedType(out Guid type);
[PreserveSig] int GetStatus(out int status);
[PreserveSig] int GetValue(nint propVariant);
}
[GeneratedComInterface]
[Guid("2cd0bd52-bcd5-4b89-b62c-eadc0c031e7d")]
internal partial interface IMFMediaEventGenerator
{
[PreserveSig] int GetEvent(uint flags, out nint mediaEvent);
[PreserveSig] int BeginGetEvent(nint callback, nint state);
[PreserveSig] int EndGetEvent(nint result, out nint mediaEvent);
[PreserveSig] int QueueEvent(uint type, in Guid extendedType, int status, nint value);
}
[GeneratedComInterface]
[Guid("bf94c121-5b05-4e6f-8000-ba598961414d")]
internal partial interface IMFTransform
{
[PreserveSig] int GetStreamLimits(out uint inputMinimum, out uint inputMaximum, out uint outputMinimum, out uint outputMaximum);
[PreserveSig] int GetStreamCount(out uint inputStreams, out uint outputStreams);
[PreserveSig] int GetStreamIDs(uint inputSize, nint inputIds, uint outputSize, nint outputIds);
[PreserveSig] int GetInputStreamInfo(uint stream, out MftInputStreamInfo info);
[PreserveSig] int GetOutputStreamInfo(uint stream, out MftOutputStreamInfo info);
[PreserveSig] int GetAttributes(out nint attributes);
[PreserveSig] int GetInputStreamAttributes(uint stream, out nint attributes);
[PreserveSig] int GetOutputStreamAttributes(uint stream, out nint attributes);
[PreserveSig] int DeleteInputStream(uint stream);
[PreserveSig] int AddInputStreams(uint count, nint ids);
[PreserveSig] int GetInputAvailableType(uint stream, uint index, out nint type);
[PreserveSig] int GetOutputAvailableType(uint stream, uint index, out nint type);
[PreserveSig] int SetInputType(uint stream, IMFMediaType? type, uint flags);
[PreserveSig] int SetOutputType(uint stream, IMFMediaType? type, uint flags);
[PreserveSig] int GetInputCurrentType(uint stream, out nint type);
[PreserveSig] int GetOutputCurrentType(uint stream, out nint type);
[PreserveSig] int GetInputStatus(uint stream, out uint flags);
[PreserveSig] int GetOutputStatus(out uint flags);
[PreserveSig] int SetOutputBounds(long lower, long upper);
[PreserveSig] int ProcessEvent(uint stream, nint mediaEvent);
[PreserveSig] int ProcessMessage(uint message, nint parameter);
[PreserveSig] int ProcessInput(uint stream, IMFSample sample, uint flags);
[PreserveSig] int ProcessOutput(uint flags, uint count, ref MftOutputDataBuffer buffers, out uint status);
}
[GeneratedComInterface]
[Guid("901db4c7-31ce-41a2-85dc-8fa0bf41b8da")]
internal partial interface ICodecAPI
{
[PreserveSig] int IsSupported(in Guid api);
[PreserveSig] int IsModifiable(in Guid api);
[PreserveSig] int GetParameterRange(in Guid api, nint minimum, nint maximum, nint step);
[PreserveSig] int GetParameterValues(in Guid api, out nint values, out uint count);
[PreserveSig] int GetDefaultValue(in Guid api, nint value);
[PreserveSig] int GetValue(in Guid api, nint value);
/// <summary>Sets a property; <paramref name="value"/> points to a VARIANT (a ComVariant).</summary>
[PreserveSig] int SetValue(in Guid api, nint value);
[PreserveSig] int RegisterForEvent(in Guid api, nint userData);
[PreserveSig] int UnregisterForEvent(in Guid api);
[PreserveSig] int SetAllDefaults();
[PreserveSig] int SetValueWithNotify(in Guid api, nint value, out nint changed, out uint count);
[PreserveSig] int SetAllDefaultsWithNotify(out nint changed, out uint count);
[PreserveSig] int GetAllSettings(nint stream);
[PreserveSig] int SetAllSettings(nint stream);
[PreserveSig] int SetAllSettingsWithNotify(nint stream, out nint changed, out uint count);
}
[StructLayout(LayoutKind.Sequential)]
internal struct MftInputStreamInfo
{
public long MaxLatency;
public uint Flags;
public uint Size;
public uint MaxLookahead;
public uint Alignment;
}
[StructLayout(LayoutKind.Sequential)]
internal struct MftOutputStreamInfo
{
public uint Flags;
public uint Size;
public uint Alignment;
}
[StructLayout(LayoutKind.Sequential)]
internal struct MftOutputDataBuffer
{
public uint StreamId;
public nint Sample;
public uint Status;
public nint Events;
}
[StructLayout(LayoutKind.Sequential)]
internal struct MftRegisterTypeInfo
{
public Guid MajorType;
public Guid Subtype;
}
/// <summary>mfplat.dll entry points and the constants this assembly uses.</summary>
internal static unsafe partial class MfNative
{
public const uint Version = 0x0002_0070; // MF_SDK_VERSION << 16 | MF_API_VERSION
public const uint StartupLite = 1; // MFSTARTUP_NOSOCKET
public const uint EnumSync = 0x1, EnumAsync = 0x2, EnumHardware = 0x4, EnumSortAndFilter = 0x40;
public const uint MessageCommandDrain = 0x1;
public const uint MessageNotifyBeginStreaming = 0x1000_0000;
public const uint MessageNotifyEndStreaming = 0x1000_0001;
public const uint MessageNotifyEndOfStream = 0x1000_0002;
public const uint MessageNotifyStartOfStream = 0x1000_0003;
public const uint OutputStreamProvidesSamples = 0x100, OutputStreamCanProvideSamples = 0x200;
public const uint EventError = 1, EventNeedInput = 601, EventHaveOutput = 602, EventDrainComplete = 603;
public const int TransformNeedMoreInput = unchecked((int)0xC00D6D72);
public const int TransformStreamChange = unchecked((int)0xC00D6D61);
public const int NotAccepting = unchecked((int)0xC00D36B5);
public const int NoMoreTypes = unchecked((int)0xC00D36B9);
public const uint InterlaceProgressive = 2;
public const uint NominalRange16To235 = 2;
public const uint PrimariesBt709 = 2;
public const uint TransferBt709 = 5;
public const uint MatrixBt709 = 1;
public const uint RateControlCbr = 0, RateControlUnconstrainedVbr = 2, RateControlQuality = 3;
[LibraryImport("mfplat.dll")]
public static partial int MFStartup(uint version, uint flags);
[LibraryImport("mfplat.dll")]
public static partial int MFShutdown();
[LibraryImport("mfplat.dll")]
public static partial int MFTEnumEx(Guid category, uint flags, MftRegisterTypeInfo* inputType, MftRegisterTypeInfo* outputType, out nint activates, out uint count);
[LibraryImport("mfplat.dll")]
public static partial int MFCreateMediaType(out nint mediaType);
[LibraryImport("mfplat.dll")]
public static partial int MFCreateSample(out nint sample);
[LibraryImport("mfplat.dll")]
public static partial int MFCreateMemoryBuffer(uint maxLength, out nint buffer);
[LibraryImport("mfplat.dll")]
public static partial int MFCreate2DMediaBuffer(uint width, uint height, uint fourCc, [MarshalAs(UnmanagedType.Bool)] bool bottomUp, out nint buffer);
}
/// <summary>Media Foundation GUIDs (mfapi.h, mftransform.h, codecapi.h).</summary>
internal static class MfGuids
{
public static readonly Guid VideoEncoderCategory = new("f79eac7d-e545-4387-bdee-d647d7bde42a");
public static readonly Guid MediaTypeVideo = new("73646976-0000-0010-8000-00aa00389b71");
public static readonly Guid FormatH264 = new("34363248-0000-0010-8000-00aa00389b71");
public static readonly Guid FormatHevc = new("43564548-0000-0010-8000-00aa00389b71");
public static readonly Guid FormatAv1 = new("31305641-0000-0010-8000-00aa00389b71");
public static readonly Guid FormatNv12 = new("3231564e-0000-0010-8000-00aa00389b71");
public static readonly Guid FormatP010 = new("30313050-0000-0010-8000-00aa00389b71");
public static readonly Guid MajorType = new("48eba18e-f8c9-4687-bf11-0a74c9f96a8f");
public static readonly Guid Subtype = new("f7e34c9a-42e8-4714-b74b-cb29d72c35e5");
public static readonly Guid FrameSize = new("1652c33d-d6b2-4012-b834-72030849a37d");
public static readonly Guid FrameRate = new("c459a2e8-3d2c-4e44-b132-fee5156c7bb0");
public static readonly Guid PixelAspectRatio = new("c6376a1e-8d0a-4027-be45-6d9a0ad39bb6");
public static readonly Guid InterlaceMode = new("e2724bb8-e676-4806-b4b2-a8d6efb44ccd");
public static readonly Guid AverageBitrate = new("20332624-fb0d-4d9e-bd0d-cbf6786c102e");
public static readonly Guid Mpeg2Profile = new("ad76a80b-2d5c-4e0b-b375-64e520137036");
public static readonly Guid Mpeg2Level = new("96f66574-11c5-4015-8666-bff516436da7");
public static readonly Guid MpegSequenceHeader = new("3c036de7-3ad0-4c9e-9216-ee6d6ac21cb3");
public static readonly Guid DefaultStride = new("644b4e48-1e02-4516-b0eb-c01ca9d49ac6");
public static readonly Guid NominalRange = new("c21b8ee5-b956-4071-8daf-325edf5cab11");
public static readonly Guid VideoPrimaries = new("dbfbe4d7-0740-4ee0-8192-850ab0e21935");
public static readonly Guid TransferFunction = new("5fb0fce9-be5c-4935-a811-ec838f8eed93");
public static readonly Guid YuvMatrix = new("3e23d450-2c75-4d25-a00e-b91670d12327");
public static readonly Guid TransformAsync = new("f81a699a-649a-497d-8c73-29f8fed6ad7a");
public static readonly Guid TransformAsyncUnlock = new("e5666d6b-3422-4eb6-a421-da7db1f8e207");
public static readonly Guid TransformFlags = new("9359bb7e-6275-46c4-a025-1c01e45f1a86");
public static readonly Guid FriendlyName = new("314ffbae-5b41-4c95-9c19-4e7d586face3");
public static readonly Guid HardwareVendorId = new("3aecb0cc-035b-4bcc-8185-2b8d551ef3af");
public static readonly Guid SampleCleanPoint = new("9cdf01d8-a0f0-43ba-b077-eaa06cbd728a");
public static readonly Guid SampleDecodeTimestamp = new("73a954d4-09e2-4861-befc-94bd97c08e6e");
public static readonly Guid CodecRateControlMode = new("1c0608e9-370c-4710-8a58-cb6181c42423");
public static readonly Guid CodecMeanBitRate = new("f7222374-2144-4815-b550-a37f8e12ee52");
public static readonly Guid CodecQuality = new("fcbf57a3-7ea5-4b0c-9644-69b40c39c391");
public static readonly Guid CodecGopSize = new("95f31b26-95a4-41aa-9303-246a7fc6eef1");
public static readonly Guid CodecBPictureCount = new("8d390aac-dc5c-4200-b57f-814d04babab2");
public static readonly Guid CodecLowLatencyMode = new("9c27891a-ed7a-40e1-88e8-b22727a024ee");
public static readonly Guid IidTransform = typeof(IMFTransform).GUID;
}