Condividi tramite

Metodo IFileSystemImage::p ut_StageFiles (imapi2fs.h)

  • Articolo

Determina se i file aggiunti all'immagine del file system devono essere sottoposti a staging prima della masterizzazione.

Sintassi

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

Parametri

[in] newVal

Impostare su VARIANT_TRUE per forzare il staging dei file aggiunti all'immagine del file system in uno o più file di fase prima di masterizzare. In caso contrario, impostare su VARIANT_FALSE se la gestione temporanea non è necessaria e sono necessarie prestazioni più elevate.

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_NOTIMPL
 Non implementato.

Valore: 0x80004001

Commenti

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

L'impostazione di questa proprietà su VARIANT_TRUE influirà solo sui file che vengono aggiunti dopo l'impostazione della proprietà: tali file verranno sempre gestiti in staging. I file di cui non è stato eseguito il staging prima di un valore di proprietà specificato di VARIANT_TRUE, non verranno eseguiti in staging.

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 sottorun del buffer durante la combustione, è necessaria una certa 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 lo staging dei file indipendentemente dal valore della proprietà specificato. Ad esempio, lo staging dei file viene applicato 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::get_StageFiles