Compartilhar via

Método IFileSystemImage::p ut_StageFiles (imapi2fs.h)

  • Artigo

Determina se os arquivos que estão sendo adicionados à imagem do sistema de arquivos devem ser preparados antes da gravação.

Sintaxe

HRESULT put_StageFiles(
  [in] VARIANT_BOOL newVal
);

Parâmetros

[in] newVal

Defina como VARIANT_TRUE para forçar os arquivos adicionados à imagem do sistema de arquivos a serem preparados em um ou mais arquivos de estágio antes da queima. Caso contrário, defina como VARIANT_FALSE se o preparo não for necessário e um desempenho mais alto for desejado.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_NOTIMPL
 Não implementado.

Valor: 0x80004001

Comentários

"Preparo" é um processo no qual uma imagem é criada no disco rígido, contendo todos os arquivos a serem queimados, antes do início da operação de gravação.

Definir essa propriedade como VARIANT_TRUE afetará apenas os arquivos adicionados depois que a propriedade for definida: esses arquivos sempre serão preparados. Os arquivos que não foram preparados antes de um valor de propriedade especificado de VARIANT_TRUE, não serão preparados.

Ao especificar VARIANT_FALSE, o processo de criação de imagem do sistema de arquivos é otimizado de duas maneiras:

  • Menos tempo é necessário para a geração de imagem
  • Menos espaço é consumido em um disco local por IMAPI
No entanto, para evitar problemas de subexecutação de buffer durante a queima, uma determinada taxa de transferência mínima é necessária para operações de leitura em arquivos não preparados. Caso a acessibilidade ou a taxa de transferência do arquivo não atendam aos requisitos do queimador, o IMAPI impõe o preparo do arquivo, independentemente do valor da propriedade especificado. Por exemplo, o preparo de arquivos é imposto para arquivos de origem de dispositivos de armazenamento removíveis, como o Disco Flash USB.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IFileSystemImage

IFileSystemImage::get_StageFiles