commande MCI_QUALITY

La commande MCI_QUALITY 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 mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_QUALITY, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_QUALITY_PARMS) lpQuality
);

Paramètres

wDeviceID

Identificateur de l’appareil MCI devant recevoir le message de commande.

dwFlags

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

lpQuality

Pointeur vers une structure MCI_DGV_QUALITY_PARMS .

Valeur renvoyée

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

Notes

Le nom défini pour ce niveau de qualité peut être utilisé lors de la définition de la qualité audio, vidéo ou toujours avec les commandes MCI_SETAUDIO et MCI_SETVIDEO .

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

MCI_QUALITY_ALG

Le membre lpstrAlgorithm de la structure identifiée par lpQuality contient l’adresse d’une mémoire tampon contenant le nom de l’algorithme. Cet algorithme doit être pris en charge par le pilote de périphérique et doit être compatible avec le descripteur audio, still ou vidéo utilisé. Si cet indicateur est omis, l’algorithme actuel est utilisé.

MCI_QUALITY_DIALOG

Le pilote de périphérique doit afficher une boîte de dialogue pour spécifier le niveau de qualité. La boîte de dialogue contient des champs spécifiques à l’algorithme utilisés en interne par le pilote de périphérique pour créer une structure décrivant un niveau de qualité spécifique.

MCI_QUALITY_HANDLE

Le membre dwHandle de la structure identifiée par lpQuality contient un handle pour une structure. La structure contient des données spécifiques à l’algorithme décrivant le niveau de qualité spécifique. Le format des structures pour les algorithmes dépend de l’appareil.

MCI_QUALITY_ITEM

Une constante indiquant le type d’algorithme est incluse dans le membre dwItem de la structure identifiée par lpQuality.

MCI_QUALITY_NAME

Le membre lpstrName de la structure identifiée par lpQuality contient l’adresse d’une mémoire tampon contenant le descripteur de qualité.

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