Partager via


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