comando reserve

O comando reserve aloca espaço em disco contíguo para o workspace da instância do dispositivo. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendString com o parâmetro lpszCommand definido da seguinte maneira.

_stprintf_s(
  lpszCommand, 
  TEXT("reserve %s %s %s"), 
  lpszDeviceID, 
  lpszReserve, 
  lpszFlags
); 

Parâmetros

lpszDeviceID

Identificador de um dispositivo MCI. Esse identificador ou alias é atribuído quando o dispositivo é aberto.

lpszReserve

Um ou mais dos sinalizadores a seguir.

Valor	Significado
no caminho	Especifica a unidade e o caminho do diretório (mas não o nome) de um arquivo temporário usado para armazenar dados gravados. O nome desse arquivo é especificado pelo dispositivo. O arquivo temporário é excluído quando o dispositivo é fechado. Se esse sinalizador for omitido, o dispositivo especificará o local do espaço em disco.
duração do tamanho	Especifica a quantidade aproximada de espaço em disco a ser reservada no workspace. O valor de duração é especificado no formato de hora atual. O dispositivo baseia sua estimativa do espaço em disco necessário nos seguintes parâmetros: o tempo solicitado, o formato do arquivo, o algoritmo de compactação de vídeo e áudio e os valores de qualidade de compactação em vigor. Se setvideo "record" estiver "desativado", o espaço será reservado apenas para áudio. Se setaudio "record" estiver "desativado", o espaço será reservado apenas para vídeo. Se ambos estiverem "desativados" ou se a duração for zero, nenhum espaço será reservado e qualquer espaço reservado existente será desalocado. Se esse sinalizador for omitido, o dispositivo usará um padrão definido pelo dispositivo.

lpszFlags

Pode ser "wait", "notify", "test" ou uma combinação deles. Para obter mais informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

Valor Retornado

Retornará zero se tiver êxito ou um erro, caso contrário.

Comentários

Se necessário, os comandos de gravação ou salvamento subsequentes usam o espaço reservado por este comando. Se o workspace contiver dados não salvos, os dados serão perdidos. Alguns dispositivos não exigem reserva e ignoram. Se o espaço em disco não estiver reservado antes da gravação, o comando de registro executará uma reserva implícita com sinalizadores padrão específicos do dispositivo. Use um comando de reserva explícito se quiser um melhor controle de quando o atraso para alocação de disco ocorrer, controle de quanto espaço é alocado e controle de onde o espaço em disco é alocado. Seu aplicativo pode alterar a quantidade e o local do espaço em disco reservado anteriormente com comandos de reserva subsequentes. Qualquer espaço em disco alocado e ainda não utilizado não é desalocado até que todos os dados gravados sejam salvos ou até que a instância do dispositivo seja fechada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]

Confira também

MCI

Cadeias de caracteres de comando MCI

record

salvar

Setaudio

setvideo