commande MCI_SET

La commande MCI_SET définit les informations sur l’appareil. Cd audio, digital-video, séquenceur MIDI, magnétoscope, vidéodisc, vidéo-superposition et audio de forme d’onde 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 d’appareil de l’appareil MCI qui doit recevoir le message de commande.

dwFlags

MCI_NOTIFY, MCI_WAIT ou, pour les appareils de vidéo numérique et de magnétoscope, 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 renvoyée

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 de 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 d’heure en octets pour l’entrée ou la sortie. Reconnu par le type d’appareil waveaudio .

MCI_FORMAT_FRAMES

Les commandes suivantes utilisent des trames. 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, secondes et 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 d’heure 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 vidéo retournent 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 les commandes d’enregistrement ou de capture. En cas d’omission, il peut s’agit d’un format défini par le pilote de périphérique par défaut. Si le format de fichier spécifié est en conflit avec l’algorithme et la qualité actuellement sélectionnés, ils sont remplacés par les valeurs 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 à l’image spécifiée avec l’indicateur MCI_FROM. Cela peut ajouter un délai supplémentaire si l’image demandée n’est pas une image clé. Si MCI_SET_OFF est spécifié, l’appareil recherche une image de clé 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 est dépendant 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 de 1 000. La demi-vitesse est de 500 et la double vitesse est de 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 sur les 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 des données de synchronisation au format MIDI.

MCI_SEQ_SMPTE

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

MCI_SEQ_NONE

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

MCI_SEQ_SET_OFFSET

Remplace le décalage SMPTE d’une séquence par celui spécifié 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 d’appareil 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, il retourne une erreur et rouvre le port utilisé précédemment (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 les 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

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

Pour les appareils de séquenceur, 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 en mode d’assemblage ou d’insertion (lorsque l’assemblage est désactivé, l’insertion est activée et vice versa). Utilisez avec l’un des indicateurs suivants :

MCI_SET_ON

Active l’enregistrement d’assemblage et désactive l’insertion d’enregistrement. Enregistre toutes les pistes vidéo, audio et timecode.

MCI_SET_OFF

Désactive l’enregistrement d’assemblage et active l’insertion d’enregistrement. Lorsque l’enregistrement d’assemblage est désactivé, des pistes individuelles de vidéo, d’audio et de 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 contre-temps à utiliser par le compteur status. 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 à l’écran 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 timecode.

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 bande vidéo, au format d’heure actuel, nécessaire pour freiner le transport du magnétoscope lorsqu’une commande d’arrêt ou de pause est émise.

MCI_VCR_SET_POWER

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

MCI_SET_OFF

Met hors tension.

MCI_SET_ON

Met sous tension.

MCI_VCR_SET_PREROLL_DURATION

Le membre dwPrerollDuration de la structure identifiée par lpSet contient la longueur de la bande vidéo, au format d’heure actuel, nécessaire pour stabiliser la sortie du magnétoscope.

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 correspond à la vitesse normale, 2000 à double vitesse et 500 à 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 le compteur exclusivement.

MCI_VCR_TIME_DETECT

Chaque fois qu’une nouvelle bande vidéo est insérée dans l’appareil ou que le mode passe de non prêt à prêt, l’appareil doit tenter de déterminer s’il existe un timecode disponible sur la vidéo. Si 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

Ajuste la vitesse du transport de bande vcR avec un réglage fin et doit être utilisé avec l’un des indicateurs suivants :

MCI_VCR_PLUS

Augmente la vitesse de transport des bandes.

MCI_VCR_MINUS

Réduit la vitesse de transport des bandes.

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 d’heure en pistes. 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 sur le 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 sur le membre nBitsPerSample du format de données PCM identifié par lpSet.

MCI_WAVE_SET_BLOCKALIGN

Définit l’alignement de blocs 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 change 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 audio de forme d’onde, 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 lors de la création du fichier pour stocker les données. 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 d’indicateurs suivante 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

Voir aussi

MCI

Commandes MCI