PhysicalDiskInfo class #455

AlphaFS.Doc/AlphaFS.Doc.shfbproj

@@ -39,8 +39,8 @@
     <SyntaxFilters>Standard</SyntaxFilters>
     <HelpFileVersion>2.2</HelpFileVersion>
     <DocumentationSources>
-      <DocumentationSource sourceFile="..\Bin\$(Configuration)\Net452\AlphaFS.dll" />
-      <DocumentationSource sourceFile="..\Bin\$(Configuration)\Net452\AlphaFS.xml" />
+      <DocumentationSource sourceFile="..\Bin\$(Configuration)\Net40\AlphaFS.dll" />
+      <DocumentationSource sourceFile="..\Bin\$(Configuration)\Net40\AlphaFS.xml" />
     </DocumentationSources>
     <FooterText>https://github.com/alphaleonis/AlphaFS/</FooterText>
     <ShowFeedbackControl>False</ShowFeedbackControl>
@@ -49,11 +49,11 @@
     <NamespaceSummaries>
       <NamespaceSummaryItem name="Alphaleonis.Win32.Filesystem" isDocumented="True">The Filesystem namespace contains classes to access and work with the local filesystem. Many of the classes in this namespace are replicas of the ones available in the System.IO namespace, but with added functionality. All methods in this namespace accept long windows unicode paths (i.e. paths starting with &lt;c&gt;\\?\&lt;/c&gt;). 
 Additional classes and methods are provided to provide more advanced functionality than that of System.IO.</NamespaceSummaryItem>
-      <NamespaceSummaryItem name="Alphaleonis.Win32.Security" isDocumented="True">This namespace contains classes directly related to security such as authentication, authorization and privilege tokens that may be needed for some file operations. For an example the SE_SECURITY_NAME privilege needs to be held to be able to modify the SACL of any file.</NamespaceSummaryItem>
-      <NamespaceSummaryItem name="(global)" isDocumented="True" />
-      <NamespaceSummaryItem name="Alphaleonis.Win32" isDocumented="True">This namespace contains general classes related to the Win32 Api.</NamespaceSummaryItem>
-      <NamespaceSummaryItem name="Alphaleonis.Win32.Network" isDocumented="True">This namespace contains network related classes.</NamespaceSummaryItem>
-    </NamespaceSummaries>
+<NamespaceSummaryItem name="Alphaleonis.Win32.Security" isDocumented="True">This namespace contains classes directly related to security such as authentication, authorization and privilege tokens that may be needed for some file operations. For an example the SE_SECURITY_NAME privilege needs to be held to be able to modify the SACL of any file.</NamespaceSummaryItem>
+<NamespaceSummaryItem name="(global)" isDocumented="True" />
+<NamespaceSummaryItem name="Alphaleonis.Win32" isDocumented="True">This namespace contains general classes related to the Win32 Api.</NamespaceSummaryItem>
+<NamespaceSummaryItem name="Alphaleonis.Win32.Network" isDocumented="True">The Network namespace contains network related classes.</NamespaceSummaryItem>
+<NamespaceSummaryItem name="Alphaleonis.Win32.Device" isDocumented="True">The Device namespace contains device related classes.</NamespaceSummaryItem></NamespaceSummaries>
     <HelpFileFormat>HtmlHelp1, Website</HelpFileFormat>
     <ComponentConfigurations>
     </ComponentConfigurations>

AlphaFS.UnitTest/AlphaFS BackupFileStream Class/AlphaFS_BackupFileStream_InitializeInstance.cs → AlphaFS.UnitTest/AlphaFS BackupFileStream Class/AlphaFS_BackupFileStream_CreateInstance.cs

@@ -30,14 +30,14 @@ public partial class AlphaFS_BackupFileStreamTest
 
 
       [TestMethod]
-      public void AlphaFS_BackupFileStream_InitializeInstance_LocalAndNetwork_Success()
+      public void AlphaFS_BackupFileStream_CreateInstance_LocalAndNetwork_Success()
       {
-         AlphaFS_BackupFileStream_InitializeInstance(false);
-         AlphaFS_BackupFileStream_InitializeInstance(true);
+         AlphaFS_BackupFileStream_CreateInstance_(false);
+         AlphaFS_BackupFileStream_CreateInstance_(true);
       }
 
 
-      private void AlphaFS_BackupFileStream_InitializeInstance(bool isNetwork)
+      private void AlphaFS_BackupFileStream_CreateInstance_(bool isNetwork)
       {
          using (var tempRoot = new TemporaryDirectory(isNetwork))
          {

AlphaFS.UnitTest/AlphaFS Device Class/AlphaFS PhysicalDisk Class/AlphaFS_Device.EnumeratePhysicalDisks_ReturnsStorageDeviceInfoForDevice.cs

@@ -0,0 +1,125 @@
+/*  Copyright (C) 2008-2018 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov
+ *  
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy 
+ *  of this software and associated documentation files (the "Software"), to deal 
+ *  in the Software without restriction, including without limitation the rights 
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+ *  copies of the Software, and to permit persons to whom the Software is 
+ *  furnished to do so, subject to the following conditions:
+ *  
+ *  The above copyright notice and this permission notice shall be included in 
+ *  all copies or substantial portions of the Software.
+ *  
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 
+ *  THE SOFTWARE. 
+ */
+
+using System;
+using System.Linq;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace AlphaFS.UnitTest
+{
+   public partial class EnumerationTest
+   {
+      // Pattern: <class>_<function>_<scenario>_<expected result>
+
+
+      [TestMethod]
+      public void AlphaFS_Device_EnumeratePhysicalDisks_ReturnsStorageDeviceInfoForDevice()
+      {
+         UnitTestConstants.PrintUnitTestHeader(false);
+
+         var driveCount = 0;
+
+         var physicalDrives = Alphaleonis.Win32.Filesystem.Volume.QueryAllDosDevices().Where(device => device.StartsWith("PhysicalDrive", StringComparison.OrdinalIgnoreCase)).ToArray();
+
+         var cdRoms = Alphaleonis.Win32.Filesystem.Volume.QueryAllDosDevices().Where(device => device.StartsWith("CdRom", StringComparison.OrdinalIgnoreCase)).ToArray();
+
+         var pDrives = Alphaleonis.Win32.Device.Local.EnumeratePhysicalDisks().OrderBy(pDiskInfo => pDiskInfo.StorageDeviceInfo.DeviceNumber).ThenByDescending(pDiskInfo => pDiskInfo.StorageDeviceInfo.PartitionNumber).ToArray();
+
+         var allPhysicalDrives = physicalDrives.Length + cdRoms.Length;
+
+
+         Console.WriteLine("Found: [{0}] physical drives.\n", allPhysicalDrives);
+
+         Assert.AreEqual(allPhysicalDrives, pDrives.Length);
+
+
+         foreach (var pDiskInfo in pDrives)
+         {
+            Console.WriteLine("#{0:000}\tPhysical Disk: [{1}]", driveCount, pDiskInfo.StorageDeviceInfo.DeviceNumber);
+
+            UnitTestConstants.Dump(pDiskInfo);
+
+            UnitTestConstants.Dump(pDiskInfo.StorageAdapterInfo, true);
+
+            UnitTestConstants.Dump(pDiskInfo.StorageDeviceInfo, true);
+
+            UnitTestConstants.Dump(pDiskInfo.StoragePartitionInfo, true);
+
+
+            Assert.IsNotNull(pDiskInfo);
+
+            Assert.IsNotNull(pDiskInfo.LogicalDrives);
+
+            Assert.IsNotNull(pDiskInfo.VolumeGuids);
+
+
+            // DosDeviceName should be the same for device.
+
+            Assert.AreEqual(pDiskInfo.DosDeviceName, pDiskInfo.PhysicalDeviceObjectName);
+
+
+            // PartitionNumber should be 0 for logical drive on dynamic disk.
+
+            if (pDiskInfo.StoragePartitionInfo.OnDynamicDisk)
+               Assert.AreNotEqual(0, pDiskInfo.StorageDeviceInfo.PartitionNumber);
+
+            else
+            {
+               // PartitionNumber should be -1 for CDRom.
+
+               if (pDiskInfo.StorageDeviceInfo.DeviceType == Alphaleonis.Win32.Device.DeviceType.CDRom)
+                  Assert.AreEqual(-1, pDiskInfo.StorageDeviceInfo.PartitionNumber);
+
+               // PartitionNumber should be > 0 for logical drive because it is not the device.
+               else
+                  Assert.AreEqual(0, pDiskInfo.StorageDeviceInfo.PartitionNumber);
+            }
+
+
+            // TotalSize depends on dynamic disk on device.
+
+            if (pDiskInfo.StoragePartitionInfo.OnDynamicDisk)
+               Assert.AreNotEqual(pDiskInfo.StorageDeviceInfo.TotalSize, pDiskInfo.StoragePartitionInfo.TotalSize);
+            else
+               Assert.AreEqual(pDiskInfo.StorageDeviceInfo.TotalSize, pDiskInfo.StoragePartitionInfo.TotalSize);
+
+
+            // Show all partition information.
+
+            if (null != pDiskInfo.StoragePartitionInfo && null != pDiskInfo.StoragePartitionInfo.GptPartitionInfo)
+               foreach (var partition in pDiskInfo.StoragePartitionInfo.GptPartitionInfo)
+                  UnitTestConstants.Dump(partition, true);
+
+            if (null != pDiskInfo.StoragePartitionInfo && null != pDiskInfo.StoragePartitionInfo.MbrPartitionInfo)
+               foreach (var partition in pDiskInfo.StoragePartitionInfo.MbrPartitionInfo)
+                  UnitTestConstants.Dump(partition, true);
+
+
+            driveCount++;
+
+            Console.WriteLine();
+         }
+
+
+         Assert.IsTrue(driveCount > 0, "No physical disks enumerated, but it is expected.");
+      }
+   }
+}

AlphaFS.UnitTest/AlphaFS Device Class/AlphaFS PhysicalDisk Class/AlphaFS_PhysicalDiskInfo.CreateInstance_UsingDevicePathFromSystemDrive_ReturnsStorageDeviceInfoForDevice.cs

@@ -0,0 +1,108 @@
+/*  Copyright (C) 2008-2018 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov
+ *  
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy 
+ *  of this software and associated documentation files (the "Software"), to deal 
+ *  in the Software without restriction, including without limitation the rights 
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+ *  copies of the Software, and to permit persons to whom the Software is 
+ *  furnished to do so, subject to the following conditions:
+ *  
+ *  The above copyright notice and this permission notice shall be included in 
+ *  all copies or substantial portions of the Software.
+ *  
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 
+ *  THE SOFTWARE. 
+ */
+
+using System;
+using System.Linq;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace AlphaFS.UnitTest
+{
+   public partial class AlphaFS_PhysicalDiskInfoTest
+   {
+      // Pattern: <class>_<function>_<scenario>_<expected result>
+
+
+      [TestMethod]
+      public void AlphaFS_PhysicalDiskInfo_CreateInstance_UsingDevicePathFromSystemDrive_ReturnsStorageDeviceInfoForDevice()
+      {
+         UnitTestConstants.PrintUnitTestHeader(false);
+
+         var deviceCount = 0;
+
+         var sourceDrive = UnitTestConstants.SysDrive;
+
+         var sourceVolume = Alphaleonis.Win32.Filesystem.Volume.GetVolumeGuid(sourceDrive);
+
+         var devicePath = new Alphaleonis.Win32.Device.PhysicalDiskInfo(sourceDrive).DevicePath;
+
+         Console.WriteLine("#{0:000}\tInput Device Path: [{1}]", ++deviceCount, devicePath);
+
+
+         var pDiskInfo = new Alphaleonis.Win32.Device.PhysicalDiskInfo(devicePath);
+
+
+         UnitTestConstants.Dump(pDiskInfo);
+
+         UnitTestConstants.Dump(pDiskInfo.StorageAdapterInfo, true);
+
+         UnitTestConstants.Dump(pDiskInfo.StorageDeviceInfo, true);
+
+         UnitTestConstants.Dump(pDiskInfo.StoragePartitionInfo, true);
+
+
+         Assert.IsNotNull(pDiskInfo);
+
+         Assert.IsNotNull(pDiskInfo.LogicalDrives);
+
+         Assert.IsNotNull(pDiskInfo.VolumeGuids);
+
+
+         // DosDeviceName should be the same for device.
+
+         Assert.AreEqual(pDiskInfo.DosDeviceName, pDiskInfo.PhysicalDeviceObjectName);
+
+         // PartitionNumber should be 0 for device.
+
+         Assert.AreEqual(0, pDiskInfo.StorageDeviceInfo.PartitionNumber);
+
+
+         // TotalSize should always match for device.
+
+         Assert.AreEqual(pDiskInfo.StorageDeviceInfo.TotalSize, pDiskInfo.StoragePartitionInfo.TotalSize);
+
+
+         // ContainsVolume should find volumes/logical drives.
+
+         Assert.IsTrue(pDiskInfo.LogicalDrives.Contains(sourceDrive, StringComparer.OrdinalIgnoreCase));
+
+         Assert.IsTrue(pDiskInfo.ContainsVolume(sourceDrive));
+
+
+         Assert.IsTrue(pDiskInfo.VolumeGuids.Contains(sourceVolume, StringComparer.OrdinalIgnoreCase));
+
+         Assert.IsTrue(pDiskInfo.ContainsVolume(sourceVolume));
+
+
+         // Show all partition information.
+
+         if (null != pDiskInfo.StoragePartitionInfo && null != pDiskInfo.StoragePartitionInfo.GptPartitionInfo)
+            foreach (var partition in pDiskInfo.StoragePartitionInfo.GptPartitionInfo)
+               UnitTestConstants.Dump(partition, true);
+
+         if (null != pDiskInfo.StoragePartitionInfo && null != pDiskInfo.StoragePartitionInfo.MbrPartitionInfo)
+            foreach (var partition in pDiskInfo.StoragePartitionInfo.MbrPartitionInfo)
+               UnitTestConstants.Dump(partition, true);
+
+
+         Console.WriteLine();
+      }
+   }
+}

AlphaFS.UnitTest/AlphaFS Device Class/AlphaFS PhysicalDisk Class/AlphaFS_PhysicalDiskInfo.CreateInstance_UsingLogicalDrivePath_ReturnsStorageDeviceInfoForVolume.cs

@@ -0,0 +1,117 @@
+/*  Copyright (C) 2008-2018 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov
+ *  
+ *  Permission is hereby granted, free of charge, to any person obtaining a copy 
+ *  of this software and associated documentation files (the "Software"), to deal 
+ *  in the Software without restriction, including without limitation the rights 
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+ *  copies of the Software, and to permit persons to whom the Software is 
+ *  furnished to do so, subject to the following conditions:
+ *  
+ *  The above copyright notice and this permission notice shall be included in 
+ *  all copies or substantial portions of the Software.
+ *  
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 
+ *  THE SOFTWARE. 
+ */
+
+using System;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace AlphaFS.UnitTest
+{
+   public partial class AlphaFS_PhysicalDiskInfoTest
+   {
+      // Pattern: <class>_<function>_<scenario>_<expected result>
+
+
+      [TestMethod]
+      public void AlphaFS_PhysicalDiskInfo_CreateInstance_UsingLogicalDrivePath_ReturnsStorageDeviceInfoForVolume()
+      {
+         UnitTestConstants.PrintUnitTestHeader(false);
+
+         var driveCount = 0;
+         Alphaleonis.Win32.Device.PhysicalDiskInfo prevDiskInfo = null;
+
+         foreach (var driveInfo in System.IO.DriveInfo.GetDrives())
+         {
+            // System.UnauthorizedAccessException: (5) Access is denied.
+            if (driveInfo.DriveType == System.IO.DriveType.Network)
+            {
+               Console.WriteLine("#{0:000}\tSkipped Network drive: [{1}]\n", ++driveCount, driveInfo.Name);
+               continue;
+            }
+
+            if (driveInfo.DriveType == System.IO.DriveType.NoRootDirectory)
+            {
+               Console.WriteLine("#{0:000}\tSkipped NoRootDirectory drive: [{1}]\n", ++driveCount, driveInfo.Name);
+               continue;
+            }
+
+
+            Console.WriteLine("#{0:000}\tInput Logical Drive Path: [{1}]", ++driveCount, driveInfo.Name);
+
+
+            var pDiskInfo = new Alphaleonis.Win32.Device.PhysicalDiskInfo(driveInfo.Name);
+
+            Assert.AreNotEqual(prevDiskInfo, pDiskInfo);
+
+            prevDiskInfo = pDiskInfo;
+
+
+            UnitTestConstants.Dump(pDiskInfo);
+
+            UnitTestConstants.Dump(pDiskInfo.StorageAdapterInfo, true);
+
+            UnitTestConstants.Dump(pDiskInfo.StorageDeviceInfo, true);
+
+            UnitTestConstants.Dump(pDiskInfo.StoragePartitionInfo, true);
+
+
+            Assert.IsNotNull(pDiskInfo);
+
+            Assert.IsNotNull(pDiskInfo.LogicalDrives);
+
+            Assert.IsNotNull(pDiskInfo.VolumeGuids);
+
+
+            // DosDeviceName should be different for logical drive.
+
+            Assert.AreNotEqual(pDiskInfo.DosDeviceName, pDiskInfo.PhysicalDeviceObjectName);
+
+
+            // PartitionNumber should be -1 for CDRom.
+
+            if (pDiskInfo.StorageDeviceInfo.DeviceType == Alphaleonis.Win32.Device.DeviceType.CDRom)
+               Assert.AreEqual(-1, pDiskInfo.StorageDeviceInfo.PartitionNumber);
+
+            // PartitionNumber should be > 0 for logical drive because it is not the device.
+            else
+               Assert.AreNotEqual(0, pDiskInfo.StorageDeviceInfo.PartitionNumber);
+
+
+            Assert.AreEqual(pDiskInfo.StorageDeviceInfo.DeviceNumber, pDiskInfo.StorageAdapterInfo.DeviceNumber);
+
+            Assert.AreEqual(pDiskInfo.StorageDeviceInfo.DeviceNumber, pDiskInfo.StoragePartitionInfo.DeviceNumber);
+
+
+            // Show all partition information.
+
+            if (null != pDiskInfo.StoragePartitionInfo && null != pDiskInfo.StoragePartitionInfo.GptPartitionInfo)
+               foreach (var partition in pDiskInfo.StoragePartitionInfo.GptPartitionInfo)
+                  UnitTestConstants.Dump(partition, true);
+
+            if (null != pDiskInfo.StoragePartitionInfo && null != pDiskInfo.StoragePartitionInfo.MbrPartitionInfo)
+               foreach (var partition in pDiskInfo.StoragePartitionInfo.MbrPartitionInfo)
+                  UnitTestConstants.Dump(partition, true);
+
+
+            Console.WriteLine();
+         }
+      }
+   }
+}