https://mokurin000.github.io • This is a web feed, also known as an Atom feed. Subscribe by copying the URL from the address bar into your newsreader. Visit About Feeds to learn more and get started. It's free. Visit website Recent posts Updated on $DATE date windows geek blog Zola2026-06-04T11:30:00+08:00https://mokurin000.github.io/tags/windows/atom.xml 2026-06-04T11:30:00+08:00 2026-06-04T11:30:00+08:00 mokurin000 https://mokurin000.github.io/blog/win32-volume-disk/ <p>Windows 下经常需要完成以下映射关系：</p> <pre class="giallo z-code"><code data-lang="plain"><span class="giallo-l"><span>盘符</span></span> <span class="giallo-l"><span> ↓</span></span> <span class="giallo-l"><span>Volume GUID</span></span> <span class="giallo-l"><span> ↓</span></span> <span class="giallo-l"><span>Disk Number + Partition Number</span></span> <span class="giallo-l"><span> ↓</span></span> <span class="giallo-l"><span>PhysicalDrive</span></span> <span class="giallo-l"><span> ↓</span></span> <span class="giallo-l"><span>硬盘型号 / SSD-HDD 类型</span></span></code></pre> <p>本文使用纯 Win32 API + Python <code>ctypes</code> 实现整个查询链路。</p> <p>需要注意的是，<code>IOCTL_STORAGE_GET_DEVICE_NUMBER</code> 等接口通常需要较高权限访问设备对象。</p> <p>如果希望采用无需管理员权限的实现方式，可以参考：</p> <ul> <li>PowerShell方式：<a rel="external" href="https://mokurin000-legacy.github.io/archives/win32-drive-letters-deviceid-harddisk-model/">win32-drive-letters-deviceid-harddisk-model</a></li> <li><a rel="external" href="https://github.com/mokurin000/listdisk-rs">listdisk-rs</a></li> <li>MSDN 中的 WMI 类（Win32_DiskDrive、Win32_DiskPartition、Win32_LogicalDisk 等）</li> </ul> <hr /> <h1 id="win32-prototype">Win32 Prototype</h1> <p>首先定义需要使用的结构体、常量以及 Win32 API 签名。</p> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-keyword">from</span><span class="z-source"> ctypes</span><span class="z-keyword"> import</span><span class="z-punctuation"> (</span></span> <span class="giallo-l"><span class="z-source"> addressof</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> byref</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> c_wchar</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> cast</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> create_string_buffer</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> create_unicode_buffer</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> get_last_error</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> POINTER</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> sizeof</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> string_at</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> Structure</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> WinDLL</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> WinError</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> wstring_at</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-keyword">from</span><span class="z-source"> ctypes</span><span class="z-punctuation">.</span><span class="z-source">wintypes</span><span class="z-keyword"> import</span><span class="z-punctuation"> (</span></span> <span class="giallo-l"><span class="z-source"> HANDLE</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> BOOL</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> BOOLEAN</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> DWORD</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> BYTE</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-source"> LPWSTR</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Load kernel32.dll (Win32 API entry point)</span></span> <span class="giallo-l"><span class="z-source">kernel32</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> WinDLL</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;kernel32&quot;</span><span class="z-punctuation">,</span><span class="z-variable z-parameter"> use_last_error</span><span class="z-keyword z-operator">=</span><span class="z-constant z-language z-python">True</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">INVALID_HANDLE_VALUE</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> HANDLE</span><span class="z-punctuation">(</span><span class="z-keyword z-operator">-</span><span class="z-constant z-numeric">1</span><span class="z-punctuation">).</span><span class="z-source">value</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Access flags</span></span> <span class="giallo-l"><span class="z-source">GENERIC_READ</span><span class="z-keyword z-operator"> =</span><span class="z-storage z-type"> 0x</span><span class="z-constant z-numeric">80000000</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Share modes</span></span> <span class="giallo-l"><span class="z-source">FILE_SHARE_READ</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"><span class="z-source">FILE_SHARE_WRITE</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 2</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Creation disposition</span></span> <span class="giallo-l"><span class="z-source">OPEN_EXISTING</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 3</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Maximum path length for legacy Win32 APIs</span></span> <span class="giallo-l"><span class="z-source">MAX_PATH</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 260</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># IOCTL control codes</span></span> <span class="giallo-l"><span class="z-source">IOCTL_STORAGE_GET_DEVICE_NUMBER</span><span class="z-keyword z-operator"> =</span><span class="z-storage z-type"> 0x</span><span class="z-constant z-numeric">2D1080</span></span> <span class="giallo-l"><span class="z-source">IOCTL_STORAGE_QUERY_PROPERTY</span><span class="z-keyword z-operator"> =</span><span class="z-storage z-type"> 0x</span><span class="z-constant z-numeric">2D1400</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Storage property IDs</span></span> <span class="giallo-l"><span class="z-source">StorageDeviceProperty</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 0</span></span> <span class="giallo-l"><span class="z-source">StorageDeviceSeekPenaltyProperty</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 7</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">PropertyStandardQuery</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 0</span></span></code></pre><h2 id="structures">Structures</h2> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type">class</span><span class="z-entity z-name z-type"> STORAGE_DEVICE_NUMBER</span><span class="z-punctuation">(</span><span class="z-entity z-other z-inherited-class">Structure</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-source"> _fields_</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;DeviceType&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # Device type (e.g. disk)</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;DeviceNumber&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # PhysicalDrive number</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;PartitionNumber&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # Partition index</span></span> <span class="giallo-l"><span class="z-punctuation"> ]</span></span> <span class="giallo-l"></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-storage z-type">class</span><span class="z-entity z-name z-type"> STORAGE_PROPERTY_QUERY</span><span class="z-punctuation">(</span><span class="z-entity z-other z-inherited-class">Structure</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-source"> _fields_</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;PropertyId&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # Property being queried</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;QueryType&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # Query type (standard query)</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;AdditionalParameters&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BYTE</span><span class="z-keyword z-operator"> *</span><span class="z-constant z-numeric"> 1</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> ]</span></span> <span class="giallo-l"></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-storage z-type">class</span><span class="z-entity z-name z-type"> STORAGE_DESCRIPTOR_HEADER</span><span class="z-punctuation">(</span><span class="z-entity z-other z-inherited-class">Structure</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-source"> _fields_</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;Version&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # Descriptor version</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;Size&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # Total size of returned buffer</span></span> <span class="giallo-l"><span class="z-punctuation"> ]</span></span> <span class="giallo-l"></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-storage z-type">class</span><span class="z-entity z-name z-type"> STORAGE_DEVICE_DESCRIPTOR</span><span class="z-punctuation">(</span><span class="z-entity z-other z-inherited-class">Structure</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-source"> _fields_</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;Version&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;Size&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;DeviceType&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BYTE</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;DeviceTypeModifier&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BYTE</span><span class="z-punctuation">),</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;RemovableMedia&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BOOLEAN</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;CommandQueueing&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BOOLEAN</span><span class="z-punctuation">),</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;VendorIdOffset&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;ProductIdOffset&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;ProductRevisionOffset&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;SerialNumberOffset&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;BusType&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;RawPropertiesLength&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # Variable-length buffer follows this field</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;RawDeviceProperties&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BYTE</span><span class="z-keyword z-operator"> *</span><span class="z-constant z-numeric"> 1</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> ]</span></span> <span class="giallo-l"></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-storage z-type">class</span><span class="z-entity z-name z-type"> DEVICE_SEEK_PENALTY_DESCRIPTOR</span><span class="z-punctuation">(</span><span class="z-entity z-other z-inherited-class">Structure</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-source"> _fields_</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;Version&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;Size&quot;</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> (</span><span class="z-punctuation z-definition z-string z-string">&quot;IncursSeekPenalty&quot;</span><span class="z-punctuation">,</span><span class="z-source"> BOOLEAN</span><span class="z-punctuation">),</span><span class="z-punctuation z-definition z-comment z-comment"> # True = HDD, False = SSD</span></span> <span class="giallo-l"><span class="z-punctuation"> ]</span></span></code></pre><h2 id="function-prototypes">Function Prototypes</h2> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Enumerate volumes</span></span> <span class="giallo-l"><span class="z-source">FindFirstVolumeW</span><span class="z-keyword z-operator"> =</span><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">FindFirstVolumeW</span></span> <span class="giallo-l"><span class="z-source">FindFirstVolumeW</span><span class="z-punctuation">.</span><span class="z-source">argtypes</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span><span class="z-source">LPWSTR</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">]</span></span> <span class="giallo-l"><span class="z-source">FindFirstVolumeW</span><span class="z-punctuation">.</span><span class="z-source">restype</span><span class="z-keyword z-operator"> =</span><span class="z-source"> HANDLE</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">FindNextVolumeW</span><span class="z-keyword z-operator"> =</span><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">FindNextVolumeW</span></span> <span class="giallo-l"><span class="z-source">FindNextVolumeW</span><span class="z-punctuation">.</span><span class="z-source">argtypes</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span><span class="z-source">HANDLE</span><span class="z-punctuation">,</span><span class="z-source"> LPWSTR</span><span class="z-punctuation">,</span><span class="z-source"> DWORD</span><span class="z-punctuation">]</span></span> <span class="giallo-l"><span class="z-source">FindNextVolumeW</span><span class="z-punctuation">.</span><span class="z-source">restype</span><span class="z-keyword z-operator"> =</span><span class="z-source"> BOOL</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">FindVolumeClose</span><span class="z-keyword z-operator"> =</span><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">FindVolumeClose</span></span> <span class="giallo-l"><span class="z-source">FindVolumeClose</span><span class="z-punctuation">.</span><span class="z-source">argtypes</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> [</span><span class="z-source">HANDLE</span><span class="z-punctuation">]</span></span> <span class="giallo-l"><span class="z-source">FindVolumeClose</span><span class="z-punctuation">.</span><span class="z-source">restype</span><span class="z-keyword z-operator"> =</span><span class="z-source"> BOOL</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Volume mount point resolver</span></span> <span class="giallo-l"><span class="z-source">GetVolumePathNamesForVolumeNameW</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> (</span></span> <span class="giallo-l"><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">GetVolumePathNamesForVolumeNameW</span></span> <span class="giallo-l"><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"># Device access</span></span> <span class="giallo-l"><span class="z-source">CreateFileW</span><span class="z-keyword z-operator"> =</span><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">CreateFileW</span></span> <span class="giallo-l"><span class="z-source">CreateFileW</span><span class="z-punctuation">.</span><span class="z-source">restype</span><span class="z-keyword z-operator"> =</span><span class="z-source"> HANDLE</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source">DeviceIoControl</span><span class="z-keyword z-operator"> =</span><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">DeviceIoControl</span></span> <span class="giallo-l"><span class="z-source">CloseHandle</span><span class="z-keyword z-operator"> =</span><span class="z-source"> kernel32</span><span class="z-punctuation">.</span><span class="z-source">CloseHandle</span></span></code></pre><h2 id="da-kai-she-bei-dui-xiang">打开设备对象</h2> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> open_device</span><span class="z-punctuation">(</span><span class="z-variable z-parameter">path</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Open a Win32 device handle (volume or physical drive).</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> h</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> CreateFileW</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> path</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> GENERIC_READ</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> FILE_SHARE_READ</span><span class="z-keyword z-operator"> |</span><span class="z-meta z-function-call z-arguments z-python"> FILE_SHARE_WRITE</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> OPEN_EXISTING</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-numeric"> 0</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> if</span><span class="z-source"> h</span><span class="z-keyword z-operator"> ==</span><span class="z-source"> INVALID_HANDLE_VALUE</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> raise</span><span class="z-meta z-function-call z-python"> WinError</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">get_last_error</span><span class="z-punctuation">())</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-source"> h</span></span></code></pre> <hr /> <h1 id="mei-ju-volume">枚举 Volume</h1> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> enum_volumes</span><span class="z-punctuation">():</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Enumerate all volume GUIDs in the system.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> buf</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> create_unicode_buffer</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">MAX_PATH</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> h</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> FindFirstVolumeW</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">buf</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> MAX_PATH</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> if</span><span class="z-source"> h</span><span class="z-keyword z-operator"> ==</span><span class="z-source"> INVALID_HANDLE_VALUE</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> raise</span><span class="z-meta z-function-call z-python"> WinError</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">get_last_error</span><span class="z-punctuation">())</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> try</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> yield</span><span class="z-source"> buf</span><span class="z-punctuation">.</span><span class="z-source">value</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> while</span><span class="z-meta z-function-call z-python"> FindNextVolumeW</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">h</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> buf</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> MAX_PATH</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> yield</span><span class="z-source"> buf</span><span class="z-punctuation">.</span><span class="z-source">value</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> finally</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> FindVolumeClose</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">h</span><span class="z-punctuation">)</span></span></code></pre> <hr /> <h1 id="volume-huo-qu-gua-zai-dian">Volume 获取挂载点</h1> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> get_mount_points</span><span class="z-punctuation">(</span><span class="z-variable z-parameter">volume_guid</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Get all mount points (drive letters / folders) for a volume.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> needed</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DWORD</span><span class="z-punctuation">()</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # First call to get required buffer size</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> GetVolumePathNamesForVolumeNameW</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> volume_guid</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-numeric"> 0</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">needed</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> if</span><span class="z-source"> needed</span><span class="z-punctuation">.</span><span class="z-source">value</span><span class="z-keyword z-operator"> ==</span><span class="z-constant z-numeric"> 0</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-punctuation"> []</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> buf</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> create_unicode_buffer</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">needed</span><span class="z-punctuation">.</span><span class="z-meta z-function-call z-arguments z-python">value</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # Second call to actually retrieve mount points</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python z-keyword z-operator z-logical z-python"> if not</span><span class="z-meta z-function-call z-python"> GetVolumePathNamesForVolumeNameW</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> volume_guid</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> buf</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> needed</span><span class="z-punctuation">.</span><span class="z-meta z-function-call z-arguments z-python">value</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">needed</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> ):</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> raise</span><span class="z-meta z-function-call z-python"> WinError</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">get_last_error</span><span class="z-punctuation">())</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> result</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> []</span></span> <span class="giallo-l"><span class="z-source"> offset</span><span class="z-keyword z-operator"> =</span><span class="z-constant z-numeric"> 0</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # Multi-string parsing (double-null terminated string list)</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> while</span><span class="z-constant z-language z-python"> True</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-source"> s</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> wstring_at</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">addressof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">buf</span><span class="z-punctuation">)</span><span class="z-keyword z-operator"> +</span><span class="z-meta z-function-call z-arguments z-python"> offset</span><span class="z-keyword z-operator"> *</span><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">c_wchar</span><span class="z-punctuation">))</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python z-keyword z-operator z-logical z-python"> if not</span><span class="z-source"> s</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> break</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> result</span><span class="z-punctuation">.</span><span class="z-meta z-function-call z-python">append</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">s</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-source"> offset</span><span class="z-keyword z-operator"> +=</span><span class="z-support z-function z-builtin z-python"> len</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">s</span><span class="z-punctuation">)</span><span class="z-keyword z-operator"> +</span><span class="z-constant z-numeric"> 1</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-source"> result</span></span></code></pre> <hr /> <h1 id="volume-huo-qu-ci-pan-hao-yu-fen-qu-hao">Volume 获取磁盘号与分区号</h1> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> volume_to_disk_info</span><span class="z-punctuation">(</span><span class="z-variable z-parameter">volume_guid</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Map a volume GUID to physical disk number and partition number.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> h</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> open_device</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">volume_guid</span><span class="z-punctuation">.</span><span class="z-meta z-function-call z-python">rstrip</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-constant z-character z-escape">\\</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">))</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> try</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-source"> result</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> STORAGE_DEVICE_NUMBER</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-source"> returned</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DWORD</span><span class="z-punctuation">()</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> ok</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DeviceIoControl</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> h</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> IOCTL_STORAGE_GET_DEVICE_NUMBER</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-constant z-numeric"> 0</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">result</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">result</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">returned</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python z-keyword z-operator z-logical z-python"> if not</span><span class="z-source"> ok</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> raise</span><span class="z-meta z-function-call z-python"> WinError</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">get_last_error</span><span class="z-punctuation">())</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-source"> result</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> finally</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> CloseHandle</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">h</span><span class="z-punctuation">)</span></span></code></pre> <hr /> <h1 id="huo-qu-ying-pan-xing-hao">获取硬盘型号</h1> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> get_disk_model</span><span class="z-punctuation">(</span><span class="z-variable z-parameter">disk_number</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Query physical disk model string via StorageDeviceProperty.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> h</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> open_device</span><span class="z-punctuation">(</span><span class="z-storage z-type z-string z-python">rf</span><span class="z-string">&quot;</span><span class="z-meta z-function-call z-arguments z-python">\\</span><span class="z-string">.\PhysicalDrive</span><span class="z-constant z-character z-format z-placeholder z-other z-python">{</span><span class="z-meta z-function-call z-arguments z-python">disk_number</span><span class="z-constant z-character z-format z-placeholder z-other z-python">}</span><span class="z-string">&quot;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> try</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-source"> query</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> STORAGE_PROPERTY_QUERY</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-source"> query</span><span class="z-punctuation">.</span><span class="z-source">PropertyId</span><span class="z-keyword z-operator"> =</span><span class="z-source"> StorageDeviceProperty</span></span> <span class="giallo-l"><span class="z-source"> query</span><span class="z-punctuation">.</span><span class="z-source">QueryType</span><span class="z-keyword z-operator"> =</span><span class="z-source"> PropertyStandardQuery</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> header</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> STORAGE_DESCRIPTOR_HEADER</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-source"> returned</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DWORD</span><span class="z-punctuation">()</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # First call: get required buffer size</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> DeviceIoControl</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> h</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> IOCTL_STORAGE_QUERY_PROPERTY</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">query</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">query</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">header</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">header</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">returned</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> buf</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> create_string_buffer</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">header</span><span class="z-punctuation">.</span><span class="z-meta z-function-call z-arguments z-python">Size</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # Second call: retrieve full descriptor</span></span> <span class="giallo-l"><span class="z-source"> ok</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DeviceIoControl</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> h</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> IOCTL_STORAGE_QUERY_PROPERTY</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">query</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">query</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> buf</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> len</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">buf</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">returned</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python z-keyword z-operator z-logical z-python"> if not</span><span class="z-source"> ok</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> raise</span><span class="z-meta z-function-call z-python"> WinError</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">get_last_error</span><span class="z-punctuation">())</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> desc</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> cast</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> buf</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> POINTER</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">STORAGE_DEVICE_DESCRIPTOR</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> ).</span><span class="z-source">contents</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> if</span><span class="z-source"> desc</span><span class="z-punctuation">.</span><span class="z-source">ProductIdOffset</span><span class="z-keyword z-operator"> ==</span><span class="z-constant z-numeric"> 0</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-punctuation z-definition z-string z-string"> &quot;&lt;unknown&gt;&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-punctuation"> (</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> string_at</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-python">addressof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">buf</span><span class="z-punctuation">)</span><span class="z-keyword z-operator"> +</span><span class="z-meta z-function-call z-arguments z-python"> desc</span><span class="z-punctuation">.</span><span class="z-meta z-function-call z-arguments z-python">ProductIdOffset</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-punctuation"> .</span><span class="z-meta z-function-call z-python">decode</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;ascii&quot;</span><span class="z-punctuation">,</span><span class="z-variable z-parameter"> errors</span><span class="z-keyword z-operator">=</span><span class="z-punctuation z-definition z-string z-string">&quot;ignore&quot;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-punctuation"> .</span><span class="z-meta z-function-call z-python">strip</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> finally</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> CloseHandle</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">h</span><span class="z-punctuation">)</span></span></code></pre> <hr /> <h1 id="pan-duan-ssd-huo-hdd">判断 SSD 或 HDD</h1> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> get_disk_kind</span><span class="z-punctuation">(</span><span class="z-variable z-parameter">disk_number</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Determine disk type using seek penalty property.</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> h</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> open_device</span><span class="z-punctuation">(</span><span class="z-storage z-type z-string z-python">rf</span><span class="z-string">&quot;</span><span class="z-meta z-function-call z-arguments z-python">\\</span><span class="z-string">.\PhysicalDrive</span><span class="z-constant z-character z-format z-placeholder z-other z-python">{</span><span class="z-meta z-function-call z-arguments z-python">disk_number</span><span class="z-constant z-character z-format z-placeholder z-other z-python">}</span><span class="z-string">&quot;</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> try</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-source"> query</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> STORAGE_PROPERTY_QUERY</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-source"> query</span><span class="z-punctuation">.</span><span class="z-source">PropertyId</span><span class="z-keyword z-operator"> =</span><span class="z-source"> StorageDeviceSeekPenaltyProperty</span></span> <span class="giallo-l"><span class="z-source"> query</span><span class="z-punctuation">.</span><span class="z-source">QueryType</span><span class="z-keyword z-operator"> =</span><span class="z-source"> PropertyStandardQuery</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> result</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DEVICE_SEEK_PENALTY_DESCRIPTOR</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-source"> returned</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DWORD</span><span class="z-punctuation">()</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> ok</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> DeviceIoControl</span><span class="z-punctuation">(</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> h</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-arguments z-python"> IOCTL_STORAGE_QUERY_PROPERTY</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">query</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">query</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">result</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> sizeof</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">result</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> byref</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">returned</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-constant z-language z-python"> None</span><span class="z-punctuation">,</span></span> <span class="giallo-l"><span class="z-punctuation"> )</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python z-keyword z-operator z-logical z-python"> if not</span><span class="z-source"> ok</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-punctuation z-definition z-string z-string"> &quot;Unknown&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> return</span><span class="z-punctuation z-definition z-string z-string"> &quot;HDD&quot;</span><span class="z-keyword z-control z-flow z-python"> if</span><span class="z-source"> result</span><span class="z-punctuation">.</span><span class="z-source">IncursSeekPenalty</span><span class="z-keyword z-control z-flow z-python"> else</span><span class="z-punctuation z-definition z-string z-string"> &quot;SSD&quot;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> finally</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-meta z-function-call z-python"> CloseHandle</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">h</span><span class="z-punctuation">)</span></span></code></pre> <hr /> <h1 id="zong-he-shu-chu">综合输出</h1> <pre class="giallo z-code"><code data-lang="python"><span class="giallo-l"><span class="z-storage z-type z-function z-python">def</span><span class="z-entity z-name z-function"> main</span><span class="z-punctuation">():</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-string"> Full mapping pipeline:</span></span> <span class="giallo-l"><span class="z-string"> Volume → Disk → Partition → Model → Type</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string"> &quot;&quot;&quot;</span></span> <span class="giallo-l"><span class="z-source"> cache</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> {}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> for</span><span class="z-source"> volume</span><span class="z-keyword z-control z-flow z-python"> in</span><span class="z-meta z-function-call z-python"> enum_volumes</span><span class="z-punctuation">():</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> try</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-source"> disk_info</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-function-call z-python"> volume_to_disk_info</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">volume</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> device_num</span><span class="z-keyword z-operator"> =</span><span class="z-source"> disk_info</span><span class="z-punctuation">.</span><span class="z-source">DeviceNumber</span></span> <span class="giallo-l"><span class="z-source"> partition_num</span><span class="z-keyword z-operator"> =</span><span class="z-source"> disk_info</span><span class="z-punctuation">.</span><span class="z-source">PartitionNumber</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-punctuation z-definition z-comment z-comment"> # Cache disk-level info to avoid repeated IOCTL calls</span></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> if</span><span class="z-source"> device_num</span><span class="z-keyword z-operator z-logical z-python"> not in</span><span class="z-source"> cache</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-meta z-indexed-name z-python"> cache</span><span class="z-punctuation">[</span><span class="z-meta z-item-access z-python">device_num</span><span class="z-punctuation">]</span><span class="z-keyword z-operator"> =</span><span class="z-punctuation"> {</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string z-string"> &quot;model&quot;</span><span class="z-punctuation">:</span><span class="z-meta z-function-call z-python"> get_disk_model</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">device_num</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation z-definition z-string z-string"> &quot;kind&quot;</span><span class="z-punctuation">:</span><span class="z-meta z-function-call z-python"> get_disk_kind</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">device_num</span><span class="z-punctuation">),</span></span> <span class="giallo-l"><span class="z-punctuation"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-source"> info</span><span class="z-keyword z-operator"> =</span><span class="z-meta z-indexed-name z-python"> cache</span><span class="z-punctuation">[</span><span class="z-meta z-item-access z-python">device_num</span><span class="z-punctuation">]</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;Volume :&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> volume</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> for</span><span class="z-source"> mount</span><span class="z-keyword z-control z-flow z-python"> in</span><span class="z-meta z-function-call z-python"> get_mount_points</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">volume</span><span class="z-punctuation">):</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;Mount :&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> mount</span><span class="z-punctuation">)</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;Disk :&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> device_num</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;Partition :&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> partition_num</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;Model :&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-indexed-name z-python"> info</span><span class="z-punctuation">[</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-string">model</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">])</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;Type :&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-indexed-name z-python"> info</span><span class="z-punctuation">[</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-string">kind</span><span class="z-punctuation z-definition z-string">&quot;</span><span class="z-punctuation">])</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span class="z-keyword z-control z-flow z-python"> except</span><span class="z-support z-type z-exception z-python"> Exception</span><span class="z-keyword z-control z-flow z-python"> as</span><span class="z-source"> e</span><span class="z-punctuation">:</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">()</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-meta z-function-call z-arguments z-python">volume</span><span class="z-punctuation">)</span></span> <span class="giallo-l"><span class="z-support z-function z-builtin z-python"> print</span><span class="z-punctuation">(</span><span class="z-punctuation z-definition z-string z-string">&quot;ERROR:&quot;</span><span class="z-punctuation">,</span><span class="z-meta z-function-call z-arguments z-python"> e</span><span class="z-punctuation">)</span></span></code></pre> <p>运行示例：</p> <pre class="giallo z-code"><code data-lang="plain"><span class="giallo-l"><span>Volume : \\?\Volume{...}\</span></span> <span class="giallo-l"><span>Mount : C:\</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span>Disk : 0</span></span> <span class="giallo-l"><span>Partition : 3</span></span> <span class="giallo-l"><span>Model : Samsung SSD 990 EVO</span></span> <span class="giallo-l"><span>Type : SSD</span></span></code></pre> <p>可通过 <a rel="external" href="https://gist.github.com/mokurin000/6516ee116cb24c63883e682c75c06c48">gist</a> 获取完整示例代码。</p>