最稳方案是用 FFmpeg.AutoGen：预加载原生库并调用 RegisterFFmpegBinaries，按顺序打开输入、查找视频流、获取解码器、分配帧、解码首包，以 best_effort_timestamp 判定首帧。
用 FFmpeg.AutoGen 读取视频首帧最稳
直接上结论：C# 原生类库（System.Drawing 或 MediaFoundation）几乎没法可靠提取任意格式视频的第一帧；真正落地用的，是封装 ffmpeg 的 FFmpeg.AutoGen。它不依赖 COM、不卡线程、支持 H.264/HEVC/AV1 等主流编码，且能精确控制解码到第 0 帧。
常见错误现象：Bitmap.FromFile 对 .mp4/.mkv 报 OutOfMemoryException；Windows.Media.Core 在 .NET 6+ 桌面项目里根本不可用；自己调 ffmpeg.exe 子进程容易卡死或路径出错。
- 必须预加载
ffmpeg.dll、avcodec.dll等原生库（NuGet 包FFmpeg.AutoGen已含，但需确保运行时能被找到） - 初始化前调用
FFmpegBinariesHelper.RegisterFFmpegBinaries，否则avformat_open_input返回负值 - 关键步骤顺序不能错：打开输入 → 查找视频流 → 获取解码器上下文 → 分配帧 → 解码第一包 → 检查
frame->pts == 0（不是所有视频第一包 PTS 都为 0，得结合frame->best_effort_timestamp判定）
VideoCapture + Mat 在 OpenCvSharp 里为什么常截不到首帧
很多人试过 OpenCvSharp 的 VideoCapture，调 cap.Set(VideoCaptureProperties.PosFrames, 0) 后 cap.Read() 却返回黑图或空帧——这不是 bug，是底层 ffmpeg 或 gstreamer 后端的 seek 行为限制。
使用场景：适合快速预览、对精度要求不高、视频源为本地文件且编码较简单（如 MJPEG）。
-
PosFrames不是逐帧跳转，而是按关键帧（I-frame）就近 seek，很多视频首帧不是 I-frame，就会跳到第 2 或第 3 帧才解出图像 - 必须在
Read()前加cap.Grab()一次，否则首帧可能被丢弃（尤其 MP4 容器） - 返回的
Mat数据类型可能是CV_8UC3，但某些 HEVC 视频会是CV_16UC1，直接转 Bitmap 会崩，得先ConvertScaleAbs
不用外部库？MediaFoundation 在 UWP/WinUI 里能行但有硬伤
如果你只跑在 Windows 10/11 上、目标平台是 UWP 或 WinUI 3，Windows.Media.Core 确实能绕过 ffmpeg，但实际用起来卡点极多。
性能影响：首次调用 MediaSource.CreateFromUri 会触发后台编解码器加载，冷启动延迟 300–800ms；同一视频反复提取封面时，MediaFrameReader 必须重建，无法复用解码器实例。
-
MediaFrameReader默认从时间戳 0 开始读，但很多 MP4 文件的 moov box 在文件末尾，会导致StartAsync失败，报错信息是0x8007000B（E_INVALIDARG） - 必须提前用
StorageFile.GetBasicPropertiesAsync检查ItemDate是否可读，否则CreateFromUri会静默失败 - 输出
SoftwareBitmap是 BGRA 格式，转WriteableBitmap时若没指定BitmapAlphaMode.Premultiplied，透明通道会错乱
提取后怎么存成高质量缩略图？别直接用 Save 方法
不管用哪种方式拿到首帧 Bitmap 或 Mat，直接调 bitmap.Save("thumb.jpg") 会导致细节糊、色偏严重——因为默认用最低质量 JPEG 编码，且忽略 EXIF 方向信息。
容易踩的坑：有些视频旋转了 90°（比如手机竖拍），但首帧像素数据本身是横置的，Bitmap 不带 orientation 元数据，保存后图就歪了。
- 用
ImageCodecInfo.GetImageEncoders()找到 JPEG 编码器，传入Encoder.Quality参数设为 95L（不是 100，100 会禁用优化） - 手动读取视频文件里的
rotatemeta（需用ffprobe或MediaInfo提前查），再对Bitmap调用RotateFlip - 如果输出要用于 Web，别存 JPG，改用
WebPEncoder（System.Drawing.Common6.0+ 支持），体积小 40% 且无损透明
真正麻烦的从来不是“怎么拿到第一帧”，而是“怎么拿到和播放器里看到一模一样的那一帧”——编码类型、色彩空间（BT.601/BT.709）、YUV 转 RGB 矩阵、是否应用 HDR tonemapping，这些都会让同一份视频在不同路径下解出完全不同的图。没做校验的话，用户截图对比时一眼就能看出差异。
