IVdsDisk3::QueryFreeExtents method (vds.h)

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Returns the free extents on the disk and aligns them to the specified alignment size.

Syntax

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

Parameters

[in] ulAlign

The alignment size, in bytes. This value must be a multiple of the disk sector size. If this parameter is zero, the default alignment value for the volume is used. The default alignment depends on the size of the disk where the volume is located. All partitions and volumes are aligned using the values under the following registry key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vds\Alignment

If this registry key is not set, the default alignment is 1 MB if the disk is 4 GB or larger, or 64 KB if the disk is smaller than 4 GB.

[out] ppFreeExtentArray

The address of a pointer variable that receives an
array of VDS_DISK_FREE_EXTENT structures, one for each free extent. Callers must free this array by using the CoTaskMemFree function. If there are no free extents, the pointer is set to NULL on output and does not need to be freed.

[out] plNumberOfFreeExtents

A pointer to a variable that receives the total number of VDS_DISK_FREE_EXTENT structures. If there are no free extents, the pointer is set to NULL on output and does not need to be freed.

Return value

This method can return standard HRESULT values, such as E_INVALIDARG or E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.

Requirements

See also

IVdsDisk3