comando MCI_RESERVE

O comando MCI_RESERVE aloca espaço de disco contíguo para o workspace da instância do driver do dispositivo para uso com a gravação subsequente. Os dispositivos de vídeo digital reconhecem esse comando.

Para enviar esse comando, chame a função mciSendCommand com os parâmetros a seguir.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESERVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESERVE_PARMS) lpReserve
);

Parâmetros

wDeviceID

Identificador de dispositivo do dispositivo MCI que deve receber a mensagem de comando.

Dwflags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Para obter informações sobre esses sinalizadores, consulte Os Sinalizadores de Espera, Notificação e Teste.

lpReserve

Ponteiro para uma estrutura MCI_DGV_RESERVE_PARMS .

Valor de retorno

Retorna zero se tiver êxito ou um erro de outra forma.

Comentários

Se o workspace contiver dados não salvos, esses dados serão perdidos. Se o espaço em disco não estiver reservado antes da gravação, o comando MCI_RECORD executará uma reserva implícita com parâmetros padrão específicos do dispositivo. Em algumas implementações, a reserva não é necessária e pode ser ignorada pelo driver do dispositivo. Reservar espaço explicitamente fornece um melhor controle sobre quando o atraso para alocação de disco ocorre, quanto espaço é alocado e onde o espaço em disco é alocado. A quantidade e o local do espaço em disco já reservados para essa instância do dispositivo podem ser alterados emitindo MCI_RESERVE novamente. 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 driver do dispositivo seja fechada.

Se o vídeo estiver desativado com o sinalizador MCI_OFF do comando MCI_SETVIDEO , o espaço reservado não incluirá nenhum vídeo. Se o áudio estiver desativado com o sinalizador MCI_OFF do comando MCI_SETAUDIO , o espaço reservado não incluirá nenhum áudio. Se o áudio e o vídeo estiverem desativados ou se o tamanho solicitado for zero, nenhum espaço será reservado e qualquer espaço reservado existente será desalocado.

Os seguintes sinalizadores adicionais se aplicam a dispositivos de vídeo digital:

MCI_DGV_RESERVE_IN

O membro lpstrPath da estrutura identificada por lpReserve contém um endereço de um buffer que contém o local de um arquivo temporário. O buffer contém apenas a unidade e o caminho do diretório do arquivo usado para armazenar dados gravados; o nome do arquivo é especificado pelo driver do dispositivo. Esse arquivo temporário é excluído quando a instância do dispositivo é fechada, a menos que seja salva explicitamente. Se esse sinalizador for omitido, o driver do dispositivo especificará onde o espaço em disco é alocado.

MCI_DGV_RESERVE_SIZE

O membro dwSize da estrutura identificada por lpReserve especifica a quantidade aproximada de espaço em disco a ser reserva no workspace para gravação. O valor é especificado no formato de hora atual. A quantidade de espaço em disco é estimada a partir do tempo solicitado e de qual formato de arquivo e algoritmo de vídeo e áudio e valores de qualidade estão em vigor. Se esse sinalizador for omitido, o driver do dispositivo poderá usar um valor padrão que ele define.

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]
Cabeçalho
Mmsystem.h (inclua Windows.h)

Confira também

MCI

Comandos MCI