comando MCI_RESERVE

El comando MCI_RESERVE asigna espacio en disco contiguo para el área de trabajo de la instancia del controlador de dispositivo para su uso con la grabación posterior. Los dispositivos de vídeo digital reconocen este comando.

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpReserve

Puntero a una estructura de MCI_DGV_RESERVE_PARMS .

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Comentarios

Si el área de trabajo contiene datos no guardados, estos datos se pierden. Si el espacio en disco no está reservado antes de la grabación, el comando MCI_RECORD realiza una reserva implícita con parámetros predeterminados específicos del dispositivo. En algunas implementaciones, la reserva no es necesaria y el controlador del dispositivo puede omitirla. Reservar espacio explícitamente proporciona un mejor control sobre cuándo se produce el retraso para la asignación de disco, cuánto espacio se asigna y dónde se asigna el espacio en disco. La cantidad y la ubicación del espacio en disco ya reservados para esta instancia de dispositivo se pueden cambiar mediante la emisión de MCI_RESERVE de nuevo. Cualquier espacio en disco asignado y todavía sin usar no se desasigna hasta que se guarden los datos grabados o hasta que se cierre la instancia del controlador de dispositivo.

Si el vídeo está desactivado con la marca MCI_OFF del comando MCI_SETVIDEO , el espacio reservado no incluye ningún vídeo. Si el audio está desactivado con la marca MCI_OFF del comando MCI_SETAUDIO , el espacio reservado no incluye ningún audio. Si el audio y el vídeo están desactivados o si el tamaño solicitado es cero, no se reserva ningún espacio y se desasigna cualquier espacio reservado existente.

Las siguientes marcas adicionales se aplican a los dispositivos de vídeo digital:

MCI_DGV_RESERVE_IN

El miembro lpstrPath de la estructura identificada por lpReserve contiene una dirección de un búfer que contiene la ubicación de un archivo temporal. El búfer contiene solo la unidad y la ruta de acceso del directorio del archivo utilizado para contener datos grabados; el nombre de archivo lo especifica el controlador del dispositivo. Este archivo temporal se elimina cuando se cierra la instancia del dispositivo a menos que se guarde explícitamente. Si se omite esta marca, el controlador de dispositivo especifica dónde se asigna espacio en disco.

MCI_DGV_RESERVE_SIZE

El miembro dwSize de la estructura identificada por lpReserve especifica la cantidad aproximada de espacio en disco que se va a reservar en el área de trabajo para la grabación. El valor se especifica en el formato de hora actual. La cantidad de espacio en disco se calcula a partir del tiempo solicitado y desde qué formato de archivo y algoritmo de audio y valores de calidad están en vigor. Si se omite esta marca, el controlador de dispositivo podría usar un valor predeterminado que define.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Mmsystem.h (incluya Windows.h)

Consulte también

MCI

Comandos MCI