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