commande quality

La commande qualité définit un niveau de qualité personnalisé pour la compression des données audio, vidéo ou image fixe. 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("quality %s %s %s"), 
  lpszDeviceID, 
  lpszQuality, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszQuality

Un ou plusieurs des indicateurs suivants. (L’un des trois indicateurs « audio », « toujours » et « vidéo » doit être présent.)

Valeur	Signification
algorithme	Associe le niveau de qualité à l’algorithme spécifié. Cet algorithme doit être pris en charge par l’appareil et être compatible avec l’indicateur « audio », « toujours » ou « vidéo » utilisé. En cas d’omission, l’algorithme actuel est utilisé.
nom audio	Indique que cette commande spécifie un niveau de qualité « audio » identifié avec le nom.
dialogue	Demande que l’appareil affiche une boîte de dialogue. Cette boîte de dialogue contient des champs spécifiques à l’algorithme qui sont utilisés en interne par l’appareil pour créer la structure décrivant un niveau de qualité spécifique.
handle handle	Spécifie un handle pour une structure qui contient des données spécifiques à l’algorithme décrivant un niveau de qualité spécifique. Les structures des données référencées par ce handle sont spécifiques à l’appareil.
still name	Indique que la commande spécifie un niveau de qualité « still » identifié avec le nom.
nom de la vidéo	Indique que la commande spécifie un niveau de qualité « vidéo » identifié avec le nom.

lpszFlags

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

Valeur renvoyée

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

Notes

Cette commande définit un nom de chaîne pour le niveau de qualité, qui peut ensuite être utilisé dans une commande setvideo « quality », setvideo « still quality » ou setaudio « quality » pour l’établir comme niveau de qualité vidéo, still ou audio-compression actuel.

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

setaudio

setvideo