commande MCI_RESERVE

La commande MCI_RESERVE alloue de l’espace de travail sur le disque contigu pour l’espace de travail du pilote de périphérique instance à utiliser lors de l’enregistrement suivant. Les appareils vidéo numériques reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

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

Paramètres

wDeviceID

Identificateur d’appareil de l’appareil MCI qui doit recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

lpReserve

Pointeur vers une structure MCI_DGV_RESERVE_PARMS .

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Notes

Si l’espace de travail contient des données non enregistrées, ces données sont perdues. Si l’espace disque n’est pas réservé avant l’enregistrement, la commande MCI_RECORD effectue une réserve implicite avec des paramètres par défaut spécifiques à l’appareil. Sur certaines implémentations, la réserve n’est pas obligatoire et peut être ignorée par le pilote de périphérique. La réservation explicite de l’espace vous permet de mieux contrôler le moment où le délai d’allocation de disque se produit, la quantité d’espace allouée et l’emplacement où l’espace disque est alloué. La quantité et l’emplacement de l’espace disque déjà réservé à cet appareil instance peuvent être modifiés en émettant à nouveau des MCI_RESERVE. L’espace disque alloué et toujours inutilisé n’est pas libéré tant que les données enregistrées ne sont pas enregistrées ou que le pilote de périphérique instance est fermé.

Si la vidéo est désactivée avec l’indicateur MCI_OFF de la commande MCI_SETVIDEO , l’espace réservé n’inclut aucune vidéo. Si l’audio est désactivé avec l’indicateur MCI_OFF de la commande MCI_SETAUDIO , l’espace réservé n’inclut aucun élément audio. Si l’audio et la vidéo sont désactivés ou si la taille demandée est égale à zéro, aucun espace n’est réservé et tout espace réservé existant est libéré.

Les indicateurs supplémentaires suivants s’appliquent aux appareils vidéo numériques :

MCI_DGV_RESERVE_IN

Le membre lpstrPath de la structure identifiée par lpReserve contient l’adresse d’une mémoire tampon contenant l’emplacement d’un fichier temporaire. La mémoire tampon contient uniquement le chemin d’accès du lecteur et du répertoire du fichier utilisé pour contenir les données enregistrées ; le nom de fichier est spécifié par le pilote de périphérique. Ce fichier temporaire est supprimé lorsque l’appareil instance est fermé, sauf s’il est enregistré explicitement. Si cet indicateur est omis, le pilote de périphérique spécifie où l’espace disque est alloué.

MCI_DGV_RESERVE_SIZE

Le membre dwSize de la structure identifiée par lpReserve spécifie la quantité approximative d’espace disque à réserver dans l’espace de travail pour l’enregistrement. La valeur est spécifiée dans le format d’heure actuel. La quantité d’espace disque est estimée à partir de la durée demandée et à partir de laquelle le format de fichier, l’algorithme vidéo et audio et les valeurs de qualité sont en vigueur. Si cet indicateur est omis, le pilote de périphérique peut utiliser une valeur par défaut qu’il définit.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI

Commandes MCI