commande MCI_SET

Notes

Communication sans biais Microsoft prend en charge un environnement diversifié et inclusionnaire. Dans ce document, il existe des références au mot « esclave ». Le Guide de style de Microsoft pour Bias-Free Communications reconnaît cela comme un mot d’exclusion. Ce libellé est utilisé comme il s’agit actuellement du libellé utilisé dans les commandes. Pour une cohérence, ce document contient ce mot. Lorsque ce mot est modifié dans les commandes, nous corrigerons ce document pour qu’il soit aligné.

La commande MCI_SET définit les informations de l’appareil. L’audio cd, la vidéo numérique, le séquenceur MIDI, le VCR, la vidéodisc, la superposition vidéo et les périphériques waveform-audio reconnaissent cette commande.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SET, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SET_PARMS) lpSet
);

Paramètres

wDeviceID

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

dwFlags

MCI_NOTIFY, MCI_WAIT ou, pour les appareils vidéo numérique et VCR, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez les indicateurs d’attente, de notification et de test.

lpSet

Pointeur vers une structure MCI_SET_PARMS . (Les appareils avec des jeux de commandes étendus peuvent remplacer cette structure par une structure spécifique à l’appareil.)

Valeur de retour

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

Notes

Les indicateurs supplémentaires suivants s’appliquent à tous les appareils prenant en charge MCI_SET :

MCI_SET_AUDIO

Un numéro de canal audio est inclus dans le membre dwAudio de la structure identifiée par lpSet. Cet indicateur doit être utilisé avec MCI_SET_ON ou MCI_SET_OFF. Utilisez l’une des constantes suivantes pour indiquer le numéro de canal :

MCI_SET_AUDIO_ALL

Tous les canaux audio.

MCI_SET_AUDIO_LEFT

Canal gauche.

MCI_SET_AUDIO_RIGHT

Canal droit.

MCI_SET_DOOR_CLOSED

Ferme la couverture multimédia (le cas échéant).

MCI_SET_DOOR_OPEN

Ouvre la couverture multimédia (le cas échéant).

MCI_SET_OFF

Désactive le canal vidéo ou audio spécifié.

MCI_SET_ON

Active le canal vidéo ou audio spécifié.

MCI_SET_TIME_FORMAT

Un paramètre de format d’heure est inclus dans le membre dwTimeFormat de la structure identifiée par lpSet. Les indicateurs suivants sont utilisés avec cet indicateur :

MCI_FORMAT_BYTES

Dans un format de données PCM (Pulse Code Modulation), modifie la description du membre de temps en octets pour l’entrée ou la sortie. Reconnu par le type d’appareil waveaudio .

MCI_FORMAT_FRAMES

Les commandes suivantes utilisent des images. Reconnu par les types d’appareils digitalvideo, vcr et videodisc .

MCI_FORMAT_HMS

Modifie le format d’heure en heures, minutes et secondes. Reconnu par les types d’appareils vcr et videodisc .

MCI_FORMAT_MILLISECONDS

Modifie le format d’heure en millisecondes. Reconnu par tous les types d’appareils.

MCI_FORMAT_MSF

Modifie le format d’heure en minutes, en secondes et en images. Reconnu par les types d’appareils cdaudio et vcr .

MCI_FORMAT_SAMPLES

Modifie le format d’heure en exemples pour l’entrée ou la sortie. Reconnu par le type d’appareil waveaudio .

MCI_FORMAT_SMPTE_24, MCI_FORMAT_SMPTE_25 et MCI_FORMAT_SMPTE_30

Définit le format d’heure sur 24, 25 et 30 images SMPTE (Society of Motion Picture and Television Engineers), respectivement. Reconnu par les types d’appareils sequencer et vcr .

MCI_FORMAT_SMPTE_30DROP

Définit le format d’heure sur 30 drop-frame SMPTE. Reconnu par les types d’appareils sequencer et vcr .

MCI_FORMAT_TMSF

Modifie le format de temps en pistes, minutes, secondes et images. (MCI utilise des numéros de suivi continus.) Reconnu par les types d’appareils cdaudio et vcr .

MCI_SET_VIDEO

Définit le signal vidéo activé ou désactivé. Cet indicateur doit être utilisé avec MCI_SET_ON ou MCI_SET_OFF. Les appareils qui n’ont pas de retour vidéo MCIERR_UNSUPPORTED_FUNCTION.

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil digitalvideo :

MCI_DGV_SET_FILEFORMAT

Un paramètre de format de fichier est inclus dans le membre dwFileFormat de la structure identifiée par lpSet. Pour les appareils vidéo numériques, le format de fichier est utilisé pour enregistrer ou capturer des commandes. S’il est omis, cela peut par défaut être défini par défaut dans un format défini par le pilote de périphérique. Si le format de fichier spécifié est en conflit avec l’algorithme et la qualité actuellement sélectionnés, ils sont modifiés par défaut pour le format de fichier. Les constantes de format de fichier suivantes sont définies :

MCI_DGV_FF_AVI

Format AVI.

MCI_DGV_FF_AVSS

Format AVSS.

MCI_DGV_FF_DIB

Format DIB.

MCI_DGV_FF_JFIF

Format JFIF.

MCI_DGV_FF_JPEG

Format JPEG.

MCI_DGV_FF_MPEG

Format MPEG.

MCI_DGV_FF_RDIB

Format DIB RLE.

MCI_DGV_FF_RJPEG

Format RJPEG.

MCI_DGV_SET_SEEK_EXACTLY

Définit le format utilisé pour le positionnement. Cet indicateur doit être utilisé avec MCI_SET_ON ou MCI_SET_OFF. Si MCI_SET_ON est spécifié, la lecture ou l’enregistrement accède précisément au cadre spécifié avec l’indicateur MCI_FROM. Cela peut ajouter un délai supplémentaire si l’image demandée n’est pas un cadre clé. Si MCI_SET_OFF est spécifié, l’appareil recherche une image clé-image qui précède le cadre demandé. Pour certains fichiers et appareils, il peut s’agir de la première image du fichier. La valeur par défaut de cet indicateur dépend de l’appareil.

MCI_DGV_SET_SPEED

Un paramètre de vitesse est inclus dans le membre dwSpeed de la structure identifiée par lpSet. La vitesse est spécifiée sous la forme d’un rapport entre la fréquence d’images nominale et la fréquence d’images souhaitée où la fréquence d’images nominale est désignée comme 1 000. La moitié de la vitesse est 500 et double vitesse est 2000. La plage de vitesse autorisée dépend également de l’appareil et éventuellement du fichier.

MCI_DGV_SET_STILL

Lorsqu’il est utilisé avec MCI_DGV_SET_FILEFORMAT, MCI_SET définit le format de fichier utilisé pour les commandes de capture.

Pour les appareils vidéo numériques, le paramètre lpSet pointe vers une structure MCI_DGV_SET_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil sequencer :

MCI_SEQ_FORMAT_SONGPTR

Définit le format d’heure en unités de pointeur de chanson.

MCI_SEQ_SET_MASTER

Définit le séquenceur comme source de données de synchronisation et indique que le type de synchronisation est spécifié dans le membre dwMaster de la structure identifiée par lpSet. MCISEQ retourne MCIERR_UNSUPPORTED_FUNCTION. Les constantes suivantes sont définies pour le type de synchronisation :

MCI_SEQ_MIDI

Le séquenceur envoie les données de synchronisation de format MIDI.

MCI_SEQ_SMPTE

Le séquenceur envoie les données de synchronisation de format SMPTE.

MCI_SEQ_NONE

Le séquenceur n’envoie pas de données de synchronisation.

MCI_SEQ_SET_OFFSET

Modifie le décalage SMPTE d’une séquence à celle spécifiée par le membre dwOffset de la structure identifiée par lpSet. Cela affecte uniquement les séquences avec un type de division SMPTE.

MCI_SEQ_SET_PORT

Définit le port MIDI de sortie d’une séquence sur celui spécifié par l’identificateur de périphérique MIDI dans le membre dwPort de la structure identifiée par lpSet. L’appareil ferme le port précédent (le cas échéant) et tente d’ouvrir et d’utiliser le nouveau port. En cas d’échec, elle retourne une erreur et rouvert le port précédemment utilisé (le cas échéant). Les constantes suivantes sont définies pour les ports :

MCI_SEQ_NONE

Ferme le port précédemment utilisé (le cas échéant). Le séquenceur se comporte exactement comme si un port était ouvert, sauf qu’aucun message MIDI n’est envoyé.

MIDI_MAPPER

Définit le port ouvert sur le mappeur MIDI.

MCI_SEQ_SET_SLAVE

Définit le séquenceur pour recevoir des données de synchronisation et indique que le type de synchronisation est spécifié dans le membre dwSlave de la structure identifiée par lpSet. MCISEQ retourne MCIERR_UNSUPPORTED_FUNCTION. Les constantes suivantes sont définies pour le type de synchronisation :

MCI_SEQ_FILE

Définit le séquenceur pour recevoir les données de synchronisation contenues dans le fichier MIDI.

MCI_SEQ_MIDI

Définit le séquenceur pour recevoir les données de synchronisation MIDI.

MCI_SEQ_NONE

Définit le séquenceur pour ignorer les données de synchronisation dans un flux MIDI.

MCI_SEQ_SMPTE

Définit le séquenceur pour recevoir les données de synchronisation SMPTE.

MCI_SEQ_SET_TEMPO

Modifie le tempo de la séquence MIDI par celui spécifié par le membre dwTempo de la structure pointée par lpSet. Pour les séquences avec le type de division PPQN, tempo est spécifié en battements par minute ; pour les séquences avec le type de division SMPTE, tempo est spécifié en images par seconde.

Pour les appareils sequencer, le paramètre lpSet pointe vers une structure MCI_SEQ_SET_PARMS .

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil vcr :

MCI_VCR_SET_ASSEMBLE_RECORD

Définit l’appareil à enregistrer dans les modes assemble ou insert (lorsque l’assemblage est désactivé, l’insertion est activée et inversement). Utilisez l’un des indicateurs suivants :

MCI_SET_ON

Définit l’enregistrement assemblez et désactive l’enregistrement d’insertion. Enregistre toutes les pistes vidéo, audio et timecode.

MCI_SET_OFF

Définit l’enregistrement assemblez désactivé et active l’enregistrement d’insertion. Lorsque l’enregistrement assemble est désactivé, des pistes individuelles de vidéo, audio et timecode peuvent être sélectionnées pour l’enregistrement.

MCI_VCR_SET_CLOCK

Le membre dwClock de la structure identifiée par lpSet contient la nouvelle heure d’horloge.

MCI_VCR_SET_COUNTER_FORMA

Le membre dwCounterFormat de la structure identifiée par lpSet contient une constante spécifiant le nouveau format de compteur à utiliser par le compteur d’état. Pour obtenir la liste des constantes valides, consultez MCI_SET_TIME_FORMAT dans la liste des indicateurs supplémentaires pour cette commande.

MCI_VCR_SET_COUNTER_VALUE

Le membre dwCounterValue de la structure identifiée par lpSet contient la nouvelle valeur de compteur.

MCI_VCR_SET_INDEX

Le membre dwIndex de la structure identifiée par lpSet contient une constante indiquant le contenu de l’affichage visuel et doit être l’une des suivantes :

MCI_VCR_INDEX_COUNTER

Affiche le compteur.

MCI_VCR_INDEX_DATE

Affiche la date.

MCI_VCR_INDEX_TIME

Affiche l’heure.

MCI_VCR_INDEX_TIMECODE

Affiche le code temporel.

Pour plus d’informations, consultez la commande MCI_INDEX .

MCI_VCR_SET_PAUSE_TIMEOUT

Le membre dwPauseTimeout de la structure identifiée par lpSet contient la durée maximale, en millisecondes, d’une commande de pause.

MCI_VCR_SET_POSTROLL_DURATION

Le membre dwPostrollDuration de la structure identifiée par lpSet contient la longueur de la vidéotape, au format d’heure actuel, nécessaire pour freiner le transport VCR lorsqu’une commande d’arrêt ou de pause est émise.

MCI_VCR_SET_POWER

Définit la mise sous tension ou la désactivation. Doit être utilisé avec l’un des indicateurs suivants :

MCI_SET_OFF

Désactive la mise hors tension.

MCI_SET_ON

Active l’alimentation.

MCI_VCR_SET_PREROLL_DURATION

Le membre dwPrerollDuration de la structure identifiée par lpSet contient la longueur de la vidéotape, au format horaire actuel, nécessaire pour stabiliser la sortie VCR.

MCI_VCR_SET_RECORD_FORMAT

Le membre dwRecordFormat de la structure identifiée par lpSet contient une constante décrivant la vitesse d’enregistrement, qui doit être l’une des suivantes :

MCI_VCR_FORMAT_EP

Enregistre à vitesse lente.

MCI_VCR_FORMAT_LP

Enregistre à vitesse moyenne lente.

MCI_VCR_FORMAT_SP

Enregistre à vitesse standard.

MCI_VCR_SET_SPEED

Le membre dwSpeed de la structure identifiée par lpSet contient le nouveau paramètre de vitesse, où 1000 est une vitesse normale, 2000 est double vitesse, et 500 est demi-vitesse, et ainsi de suite.

MCI_VCR_SET_TAPE_LENGTH

Le membre dwTapeLength de la structure identifiée par lpSet contient la nouvelle longueur de la bande, à condition que la longueur de la bande soit indétectable.

MCI_VCR_SET_TIME_MODE

Le membre dwTimeMode de la structure identifiée par lpSet contient une constante indiquant le nouveau mode de temps positionnel. Les constantes suivantes sont valides :

MCI_VCR_TIME_COUNTER

Force l’appareil à utiliser exclusivement le compteur.

MCI_VCR_TIME_DETECT

Chaque fois qu’une nouvelle cassette vidéo est insérée dans l’appareil ou que le mode change de non prêt à l’emploi, l’appareil doit tenter de déterminer s’il existe un code temporel disponible sur la vidéotape. Si le timecode est disponible, utilisez timecode dans toutes les commandes suivantes qui spécifient des positions. Sinon, utilisez le compteur.

MCI_VCR_TIME_TIMECODE

Force l’appareil à utiliser le timecode exclusivement.

MCI_VCR_SET_TRACKING

Tunes la vitesse du transport de bande VCR avec un ajustement fin et doit être utilisé avec l’un des indicateurs suivants :

MCI_VCR_PLUS

Augmente la vitesse de transport de bande.

MCI_VCR_MINUS

Réduit la vitesse de transport de bande.

MCI_VCR_RESET

Retourne l’ajustement de suivi à zéro.

Pour les appareils VCR, le paramètre lpSet pointe vers une structure MCI_VCR_SET_PARMS .

L’indicateur supplémentaire suivant est utilisé avec le type d’appareil videodisc :

MCI_VD_FORMAT_TRACK

Modifie le format de temps pour effectuer les suivis. MCI utilise des numéros de suivi continus.

Les indicateurs supplémentaires suivants sont utilisés avec le type d’appareil waveaudio :

MCI_WAVE_INPUT

Définit l’entrée utilisée pour l’enregistrement au membre wInput de la structure identifiée par lpSet.

MCI_WAVE_OUTPUT

Définit la sortie utilisée pour la lecture sur le membre wOutput de la structure identifiée par lpSet.

MCI_WAVE_SET_ANYINPUT

Toute entrée d’onde compatible avec le format actuel peut être utilisée pour l’enregistrement.

MCI_WAVE_SET_ANYOUTPUT

Toute sortie d’onde compatible avec le format actuel peut être utilisée pour la lecture.

MCI_WAVE_SET_AVGBYTESPERSEC

Définit les octets par seconde utilisés pour la lecture, l’enregistrement et l’enregistrement dans le membre nAvgBytesPerSec de la structure identifiée par lpSet.

MCI_WAVE_SET_BITSPERSAMPLE

Définit les bits par exemple utilisés pour la lecture, l’enregistrement et l’enregistrement dans le membre nBitsPerSample du format de données PCM identifié par lpSet.

MCI_WAVE_SET_BLOCKALIGN

Définit l’alignement du bloc utilisé pour la lecture, l’enregistrement et l’enregistrement sur le membre nBlockAlign de la structure identifiée par lpSet.

MCI_WAVE_SET_CHANNELS

Le nombre de canaux est indiqué dans le membre nChannels de la structure identifiée par lpSet.

MCI_WAVE_SET_FORMATTAG

Définit le type de format utilisé pour la lecture, l’enregistrement et l’enregistrement dans le membre wFormatTag de la structure identifiée par lpSet. La spécification de WAVE_FORMAT_PCM modifie le format en PCM.

MCI_WAVE_SET_SAMPLESPERSEC

Définit les exemples par seconde utilisés pour la lecture, l’enregistrement et l’enregistrement dans le membre nSamplesPerSec de la structure identifiée par lpSet.

Pour les appareils waveform-audio, le paramètre lpSet pointe vers une structure MCI_WAVE_SET_PARMS .

Plusieurs propriétés des données audio de forme d’onde sont définies lorsque le fichier à stocker les données est créé. Ces propriétés décrivent comment les données sont structurées dans le fichier et ne peuvent pas être modifiées une fois l’enregistrement commencé. La liste suivante des indicateurs identifie ces propriétés :

• MCI_WAVE_SET_AVGBYTESPERSEC
• MCI_WAVE_SET_BITSPERSAMPLE
• MCI_WAVE_SET_BLOCKALIGN
• MCI_WAVE_SET_CHANNELS
• MCI_WAVE_SET_FORMATTAG
• MCI_WAVE_SET_SAMPLESPERSEC

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 (include Windows.h)

Voir aussi

MCI

Commandes MCI