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] |