Compartilhar via

Método IFileSystemImage::get_StageFiles (imapi2fs.h)

  • Artigo

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

Sintaxe

HRESULT get_StageFiles(
  [out] VARIANT_BOOL *pVal
);

Parâmetros

[out] pVal

VARIANT_TRUE se os arquivos que estão sendo adicionados à imagem do sistema de arquivos precisarem ser preparados em um ou mais arquivos de estágio antes da queima. Caso contrário, VARIANT_FALSE será retornado se o IMAPI tiver permissão para otimizar o processo de criação de imagem, não preparando os arquivos que estão sendo adicionados à imagem do sistema de arquivos.

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_POINTER
 O ponteiro não é válido.

Valor: 0x80004003

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 por meio de IFileSystemImage::p ut_StageFiles 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::p ut_StageFiles