commande reserve

La commande reserve alloue de l’espace de travail contigu pour l’espace de travail de l’appareil instance. Les appareils vidéo numériques reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("reserve %s %s %s"), 
  lpszDeviceID, 
  lpszReserve, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszReserve

Un ou plusieurs des indicateurs suivants.

Valeur	Signification
dans le chemin d’accès	Spécifie le chemin du lecteur et du répertoire (mais pas le nom) d’un fichier temporaire utilisé pour contenir les données enregistrées. Le nom de ce fichier est spécifié par l’appareil. Le fichier temporaire est supprimé lorsque l’appareil est fermé. Si cet indicateur est omis, l’appareil spécifie l’emplacement de l’espace disque.
durée de taille	Spécifie la quantité approximative d’espace disque à réserver dans l’espace de travail. La valeur de durée est spécifiée dans le format d’heure actuel. L’appareil base son estimation de l’espace disque requis sur les paramètres suivants : l’heure demandée, le format de fichier, l’algorithme de compression vidéo et audio et les valeurs de qualité de compression en vigueur. Si setvideo « record » est « désactivé », l’espace est réservé uniquement à l’audio. Si setaudio « record » est « off », l’espace est réservé uniquement à la vidéo. Si les deux sont « désactivés », ou si la durée est égale à zéro, aucun espace n’est réservé et tout espace réservé existant est libéré. Si cet indicateur est omis, l’appareil utilise une valeur par défaut définie par l’appareil.

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’une combinaison de ceux-ci. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

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

Notes

Si nécessaire, les commandes d’enregistrement ou d’enregistrement suivantes utilisent l’espace réservé par cette commande. Si l’espace de travail contient des données non enregistrées, les données sont perdues. Certains appareils ne nécessitent pas de réserve et ne l’ignorent pas. Si l’espace disque n’est pas réservé avant l’enregistrement, la commande d’enregistrement effectue une réserve implicite avec des indicateurs par défaut spécifiques à l’appareil. Utilisez une commande de réserve explicite si vous souhaitez mieux contrôler le moment où se produit le délai d’allocation de disque, le contrôle de la quantité d’espace alloué et le contrôle de l’emplacement où l’espace disque est alloué. Votre application peut modifier la quantité et l’emplacement de l’espace disque précédemment réservé avec les commandes de réserve suivantes. L’espace disque alloué et toujours inutilisé n’est pas libéré tant que les données enregistrées n’ont pas été enregistrées, ou jusqu’à ce que l’appareil instance soit fermé.

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]

Voir aussi

MCI

Chaînes de commande MCI

enregistrement

enregistrer

setaudio

setvideo