comando MCI_RESERVE
O comando MCI_RESERVE aloca espaço em disco contíguo para o workspace da instância do driver do dispositivo para uso com 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 Retornado
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 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 nenhum dado gravado seja salvo 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 reservada 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 definido por ele.
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 |
|