Files
Chronos/src/Titano.Core.Windows/Devices/VolumeInfo.cs
T
Claude 113637d707 feat(windows): add removable volume watcher, ejector and format dialog
VolumeInfo reads label, file system, serial, capacity, drive type and DCIM
presence (no "insert disk" prompts) and exposes the card identity
{serial:X8}-{label}-{capacity}. RemovableVolumeWatcher runs a hidden
top-level window on its own message loop for WM_DEVICECHANGE volume unit
masks (message-only windows receive no broadcasts) plus a 3 s DriveInfo poll,
diffing snapshots so each change is raised once. VolumeEjector locks
(with retries), dismounts, allows removal and ejects; FormatDialog shows
SHFormatDrive with quick format preselected and refuses the system drive.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-02 09:46:26 +00:00

93 lines
3.7 KiB
C#

using System.Globalization;
namespace Titano.Core.Windows.Devices;
/// <summary>GetDriveTypeW results.</summary>
public enum VolumeDriveType
{
Unknown = 0,
NoRootDirectory = 1,
Removable = 2,
Fixed = 3,
Remote = 4,
CdRom = 5,
RamDisk = 6,
}
/// <summary>A mounted volume with the facts card import needs (BRIEF §12.4, §13).</summary>
/// <param name="RootPath">Root with trailing separator, e.g. <c>E:\</c>.</param>
/// <param name="Label">Volume label (may be empty).</param>
/// <param name="FileSystem">File system name, e.g. exFAT.</param>
/// <param name="SerialNumber">Volume serial number assigned at format time.</param>
/// <param name="TotalBytes">Capacity in bytes.</param>
/// <param name="FreeBytes">Free bytes available to the current user.</param>
/// <param name="DriveType">Drive type reported by Windows.</param>
/// <param name="HasDcim">A <c>DCIM</c> folder exists at the root (camera card).</param>
public sealed record VolumeInfo(
string RootPath,
string Label,
string FileSystem,
uint SerialNumber,
long TotalBytes,
long FreeBytes,
VolumeDriveType DriveType,
bool HasDcim)
{
private const int MaxPath = 261;
public char DriveLetter => char.ToUpperInvariant(RootPath[0]);
/// <summary>Card identity <c>{serial:X8}-{label}-{capacity}</c> (BRIEF §13); stable across readers and drive letters.</summary>
public string Identity => string.Create(CultureInfo.InvariantCulture, $"{SerialNumber:X8}-{Label}-{TotalBytes}");
/// <summary>Reads a volume; null when the root does not exist or holds no media (empty card reader).</summary>
public static unsafe VolumeInfo? TryRead(string rootPath)
{
var root = NormalizeRoot(rootPath);
var driveType = (VolumeDriveType)VolumeNative.GetDriveType(root);
if (driveType is VolumeDriveType.Unknown or VolumeDriveType.NoRootDirectory) return null;
VolumeNative.SetThreadErrorMode(VolumeNative.SEM_FAILCRITICALERRORS, out var previousMode);
try
{
var label = stackalloc char[MaxPath];
var fileSystem = stackalloc char[MaxPath];
if (!VolumeNative.GetVolumeInformation(root, label, MaxPath, out var serial, out _, out _, fileSystem, MaxPath)) return null;
if (!VolumeNative.GetDiskFreeSpaceEx(root, out var free, out var total, out _)) return null;
return new VolumeInfo(
root,
new string(label),
new string(fileSystem),
serial,
(long)total,
(long)free,
driveType,
Directory.Exists(Path.Combine(root, "DCIM")));
}
finally
{
VolumeNative.SetThreadErrorMode(previousMode, out _);
}
}
/// <summary>Every ready fixed or removable volume, enumerated through <see cref="DriveInfo"/> (network and optical drives are skipped).</summary>
public static IReadOnlyList<VolumeInfo> ListLocal()
{
var volumes = new List<VolumeInfo>();
foreach (var drive in DriveInfo.GetDrives())
{
if (drive.DriveType is not (System.IO.DriveType.Fixed or System.IO.DriveType.Removable)) continue;
if (TryRead(drive.Name) is { } volume) volumes.Add(volume);
}
return volumes;
}
/// <summary>"e:", "E:\" or "E:\DCIM" → "E:\".</summary>
internal static string NormalizeRoot(string path)
{
var root = Path.GetPathRoot(path);
if (string.IsNullOrEmpty(root)) throw new ArgumentException("The path has no root.", nameof(path));
return root.EndsWith('\\') ? root.ToUpperInvariant() : root.ToUpperInvariant() + "\\";
}
}