commande MCI_WINDOW

Article
06/13/2023

La commande MCI_WINDOW spécifie la fenêtre et les caractéristiques de fenêtre pour les périphériques graphiques. Les appareils de vidéo numérique et de superposition vidéo reconnaissent cette commande.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_WINDOW, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpWindow
);

Paramètres

wDeviceID: Identificateur de l’appareil MCI devant recevoir le message de commande.
dwFlags: MCI_NOTIFY, MCI_WAIT ou, pour les appareils vidéo numériques, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
lpWindow: Pointeur vers une structure MCI_GENERIC_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 une erreur dans le cas contraire.

Notes

Les appareils graphiques doivent créer une fenêtre par défaut lorsqu’un appareil est ouvert, mais ne doivent pas l’afficher tant qu’ils n’ont pas reçu la commande MCI_PLAY . La commande MCI_WINDOW permet de fournir une fenêtre créée par l’application à l’appareil et de modifier les caractéristiques d’affichage d’une fenêtre d’affichage définie par l’application ou par défaut. Si l’application fournit la fenêtre d’affichage, elle doit être prête à mettre à jour un rectangle non valide sur la fenêtre.

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

MCI_DGV_WINDOW_HWND: Le handle de la fenêtre nécessaire à l’utilisation en tant que destination est inclus dans le membre hWnd de la structure identifiée par lpWindow.
MCI_DGV_WINDOW_STATE: Le membre nCmdShow de la structure identifiée par lpWindow contient des paramètres pour définir l’état de la fenêtre.
MCI_DGV_WINDOW_TEXT: Le membre lpstrText de la structure identifiée par lpWindow contient l’adresse d’une mémoire tampon contenant les légende utilisées dans la barre de titre de la fenêtre.

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

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

MCI_OVLY_WINDOW_DISABLE_STRETCH: Désactive l’étirement de l’image.
MCI_OVLY_WINDOW_ENABLE_STRETCH: Active l’étirement de l’image.
MCI_OVLY_WINDOW_HWND: Le handle de la fenêtre utilisée pour la destination est inclus dans le membre hWnd de la structure identifiée par lpWindow. Définissez cet indicateur sur MCI_OVLY_WINDOW_DEFAULT pour revenir à la fenêtre par défaut.
MCI_OVLY_WINDOW_STATE: Le membre nCmdShow de la structure lpWindow contient des paramètres pour définir l’état de la fenêtre. Cet indicateur équivaut à appeler ShowWindow avec le paramètre state . Les constantes sont les mêmes que celles définies dans WINDOWS. H (par exemple, SW_HIDE, SW_MINIMIZE ou SW_SHOWNORMAL).
MCI_OVLY_WINDOW_TEXT: Le membre lpstrText de la structure identifiée par lpWindow contient l’adresse d’une mémoire tampon contenant les légende utilisées pour la fenêtre.

Pour les appareils de superposition vidéo, le paramètre lpWindow pointe vers une structure MCI_OVLY_WINDOW_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