Metodo IVdsDisk3::QueryFreeExtents (vds.h)

Articolo
03/08/2023

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Restituisce gli extent liberi sul disco e li allinea alle dimensioni di allineamento specificate.

Sintassi

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

Parametri

[in] ulAlign

Dimensioni di allineamento, in byte. Questo valore deve essere un multiplo delle dimensioni del settore del disco. Se questo parametro è zero, viene usato il valore di allineamento predefinito per il volume. L'allineamento predefinito dipende dalle dimensioni del disco in cui si trova il volume. Tutte le partizioni e i volumi sono allineati usando i valori nella chiave del Registro di sistema seguente:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vds\Alignment

Se questa chiave del Registro di sistema non è impostata, l'allineamento predefinito è 1 MB se il disco è pari a 4 GB o maggiore o 64 KB se il disco è inferiore a 4 GB.

[out] ppFreeExtentArray

Indirizzo di una variabile puntatore che riceve un oggetto
matrice di strutture VDS_DISK_FREE_EXTENT , una per ogni estensione libera. I chiamanti devono liberare questa matrice usando la funzione CoTaskMemFree . Se non sono presenti estensioni gratuite, il puntatore è impostato su NULL sull'output e non deve essere liberato.

[out] plNumberOfFreeExtents

Puntatore a una variabile che riceve il numero totale di strutture VDS_DISK_FREE_EXTENT . Se non sono presenti estensioni gratuite, il puntatore è impostato su NULL sull'output e non deve essere liberato.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice/valore restituito	Descrizione
S_OK	Le informazioni sull'estensione gratuita sono state restituite correttamente.
S_FALSE	Non sono presenti estensioni gratuite sul disco.
VDS_E_ALIGN_NOT_SECTOR_SIZE_MULTIPLE 0x80042554L	Il valore di allineamento specificato nel parametro ulAlign non è un multiplo delle dimensioni del settore del disco.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h

Vedi anche

IVdsDisk3

Condividi tramite