共用方式為

IVdsDisk3：：QueryFreeExtents 方法 (vds.h)

  • 發行項

[從Windows 8和Windows Server 2012開始，虛擬磁碟服務COM 介面會由Windows 儲存體管理 API取代。

傳回磁片上的可用範圍，並將其對齊指定的對齊大小。

語法

HRESULT QueryFreeExtents(
  [in]  ULONG                ulAlign,
  [out] VDS_DISK_FREE_EXTENT **ppFreeExtentArray,
  [out] LONG                 *plNumberOfFreeExtents
);

參數

[in] ulAlign

對齊大小，以位元組為單位。 此值必須是磁片磁區大小的倍數。 如果此參數為零，則會使用磁片區的預設對齊值。 預設對齊方式取決於磁片區所在的磁片大小。 所有分割區和磁片區都會使用下列登錄機碼下的值來對齊：

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vds\Alignment

如果未設定此登錄機碼，則如果磁片為 4 GB 或更大，則預設對齊方式為 1 MB，如果磁片小於 4 GB，則為 64 KB。

[out] ppFreeExtentArray

接收 的指標變數位址
VDS_DISK_FREE_EXTENT結構的陣列，每個可用範圍各一個。 呼叫端必須使用 CoTaskMemFree 函式釋放此陣列。 如果沒有自由範圍，指標會在輸出上設定為 Null ，而且不需要釋放。

[out] plNumberOfFreeExtents

接收 VDS_DISK_FREE_EXTENT 結構總數之變數的指標。 如果沒有自由範圍，指標會在輸出上設定為 Null ，而且不需要釋放。

傳回值

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。 它也可以使用HRESULT_FROM_WIN32宏傳回已轉換的系統錯誤碼。 錯誤可能源自 VDS 本身，或來自正在使用的基礎 VDS 提供者 。 可能的傳回值包括下列專案。

傳回碼/值 描述
S_OK
 已成功傳回自由範圍資訊。
S_FALSE
 磁片上沒有可用範圍。
VDS_E_ALIGN_NOT_SECTOR_SIZE_MULTIPLE
0x80042554L
 ulAlign參數中指定的對齊值不是磁片磁區大小的倍數。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平臺 Windows
標頭 vds.h

另請參閱

IVdsDisk3