Metodo IFileSystemImage::get_StageFiles (imapi2fs.h)

  • Articolo

Indica se i file aggiunti all'immagine del file system devono essere distribuiti prima del burn.

Sintassi

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

Parametri

[out] pVal

VARIANT_TRUE se i file aggiunti all'immagine del file system devono essere distribuiti in uno o più file di fase prima della combustione. In caso contrario, VARIANT_FALSE viene restituito se IMAPI è autorizzato a ottimizzare il processo di creazione dell'immagine non eseguendo la gestione temporanea dei file aggiunti all'immagine del file system.

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_POINTER
 Puntatore non valido.

Valore: 0x80004003

Commenti

"Staging" è un processo in cui viene creata un'immagine sul disco rigido, contenente tutti i file da masterizzare, prima dell'avvio dell'operazione di burn.

L'impostazione di questa proprietà su VARIANT_TRUE tramite IFileSystemImage::p ut_StageFiles influisce solo sui file aggiunti dopo l'impostazione della proprietà: questi file verranno sempre impostati. I file che non sono stati eseguiti prima di un valore di proprietà specificato di VARIANT_TRUE, non verranno eseguiti in fase.

Specificando VARIANT_FALSE, il processo di creazione dell'immagine del file system è ottimizzato in due modi:

  • È necessario meno tempo per la generazione di immagini
  • Meno spazio viene utilizzato in un disco locale da IMAPI
Tuttavia, per evitare problemi di esecuzione del buffer durante la combustione, è necessaria una determinata velocità effettiva minima per le operazioni di lettura su file non a fasi. Nel caso in cui l'accessibilità o la velocità effettiva dei file non soddisfino i requisiti del masterizzatore, IMAPI applica la gestione temporanea dei file indipendentemente dal valore della proprietà specificato. Ad esempio, la gestione temporanea dei file viene applicata per i file di origine da dispositivi di archiviazione rimovibili, ad esempio USB Flash Disk.

Requisiti

Requisito Valore
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 imapi2fs.h

Vedi anche

IFileSystemImage

IFileSystemImage::p ut_StageFiles