commande MCI_FREEZE

Article
06/13/2023

La commande MCI_FREEZE fige le mouvement sur l’affichage. Les appareils de vidéo numérique, de superposition vidéo et de magnétoscope reconnaissent cette commande.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

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.
lpFreeze: Pointeur vers une structure MCI_GENERIC_PARMS . (Les appareils avec des paramètres supplémentaires 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 sont utilisés par le type d’appareil digitalvideo :

MCI_DGV_FREEZE_AT: Le membre rc de la structure identifiée par lpFreeze contient un rectangle valide. Le rectangle spécifie une région dans la mémoire tampon d’image dont le bit de masque de verrouillage pour chaque pixel est activé. Les pixels spécifiés ne seront pas mis à jour tant que leur bit de masque de verrouillage n’est pas désactivé. Si cet indicateur n’est pas spécifié, le rectangle est défini par défaut sur la mémoire tampon d’image entière. Cet indicateur est pris en charge uniquement si la commande MCI_GETDEVCAPS retourne TRUE pour l’indicateur MCI_DGV_GETDEVCAPS_CAN_LOCK.
MCI_DGV_FREEZE_OUTSIDE: La zone située en dehors de la région spécifiée pour l’indicateur MCI_DGV_FREEZE_AT est figée.

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

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

MCI_VCR_FREEZE_FIELD: Figer un seul membre de l’image actuelle.
MCI_VCR_FREEZE_FRAME: Figer les deux champs de l’image actuelle.
MCI_VCR_FREEZE_INPUT: Figer l’image actuelle sur l’écran (utilisée pour l’enregistrement).
MCI_VCR_FREEZE_OUTPUT: Figer l’image actuelle du magnétoscope (utilisé avec la capture d’images).

Pour les appareils vcR, le paramètre lpFreeze pointe vers une structure MCI_GENERIC_PARMS .

L’indicateur supplémentaire suivant est utilisé par le type d’appareil de superposition :

MCI_OVLY_RECT: Le membre rc de la structure identifiée par lpFreeze contient un rectangle valide. Si cet indicateur n’est pas spécifié, le pilote de périphérique fige l’ensemble du cadre.

Pour les appareils de superposition vidéo, le paramètre lpFreeze pointe vers une structure MCI_OVLY_RECT_PARMS .

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

Partager via