Metodo IDiscFormat2Data::get_FreeSectorsOnMedia (imapi2.h)

Recupera il numero di settori gratuiti nel disco per la registrazione incrementale (senza sovrascrivere i dati esistenti).

Nota Quando questo metodo viene chiamato per DVD-/+RW, DVD-RAM e supporti BD-RE, il valore del settore libero segnalato rappresenta la capacità totale, anziché il numero corrente di settori gratuiti. Per recuperare i settori gratuiti per questi tipi di supporti, è necessario importare il file system tramite IFileSystemImage::ImportFileSystem o IFileSystemImage::ImportSpecificFileSystem, che consentirà l'uso del metodo IFileSystemImage:: get_FreeMediaBlocks per recuperare il valore.

 

Sintassi

HRESULT get_FreeSectorsOnMedia(
  [out] LONG *value
);

Parametri

[out] value

Numero di settori gratuiti nel supporto nel dispositivo.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi. Valore: 0x80070057
E_POINTER	Puntatore non valido. Valore: 0x80004003
E_FAIL	Errore non specificato. Valore: 0x80004005
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	Il dispositivo non è riuscito a accettare il comando entro il periodo di timeout. Questo può essere causato dal dispositivo che ha immesso uno stato incoerente o il valore di timeout per il comando potrebbe essere aumentato. Valore: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	Il dispositivo ha segnalato dati imprevisti o non validi per un comando. Valore: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	Il supporto viene inserito sottosopra. Valore: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento. Valore: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	Nel dispositivo non sono presenti supporti. Valore: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	Il supporto è attualmente formattato. Attendere il completamento del formato prima di tentare di usare il supporto. Valore: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	L'unità ha segnalato che esegue un'operazione a esecuzione prolungata, ad esempio il completamento di una scrittura. L'unità potrebbe non essere utilizzabile per un lungo periodo di tempo. Valore: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	La scrittura non è riuscita perché l'unità non ha ricevuto i dati abbastanza rapidamente per continuare a scrivere. Lo spostamento dei dati di origine nel computer locale, la riduzione della velocità di scrittura o l'abilitazione di un'impostazione "buffer in esecuzione gratuita" può risolvere questo problema. Valore: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Il supporto non è compatibile o di formato fisico sconosciuto. Valore: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	La struttura DVD non è presente. Ciò può essere causato da unità/media incompatibili usate. Valore: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	Il dispositivo ha segnalato che la pagina della modalità richiesta (e tipo) non è presente. Valore: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	L'unità ha segnalato che la combinazione di parametri forniti nella pagina della modalità per un comando MODE SELECT non è supportata. Valore: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	L'unità ha segnalato che il supporto è protetto da scrittura. Valore: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	La velocità del supporto non è compatibile con il dispositivo. Questo può essere causato dall'uso di supporti di velocità superiori o inferiori rispetto all'intervallo di velocità supportato dal dispositivo. Valore: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	L'handle specificato non è valido. Valore: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	La risorsa di rete o il dispositivo specificati non sono più disponibili. Valore: 55
E_IMAPI_RECORDER_LOCKED	Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'errore di questa operazione. Valore: 0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE	L'operazione richiesta è valida solo con supporti supportati. Valore: 0xC0AA0402

Commenti

Il valore di questa proprietà è effettivamente il numero di settori disponibili sul disco per l'operazione di scrittura. I settori dei filtri dei valori utilizzati nella gestione dello spazio del disco e della qualità dei dati, ad esempio blocchi di esecuzione e postgaps.

Nota Per i dischi sovrascrivibili, che hanno una sola sessione fisica, il numero di settori gratuiti indicati dal valore sarà sempre il numero totale di settori sul disco.

 

Se IDiscFormat2Data::p ut_ForceOverwrite è impostato su VARIANT_TRUE, usare invece la proprietà IDiscFormat2Data::get_TotalSectorsOnMedia .

Requisiti

Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2.h

Vedi anche

IDiscFormat2Data

IDiscFormat2Data::get_TotalSectorsOnMedia