MCIWndCreateA, fonction (vfw.h)

Article
08/27/2023

La fonction MCIWndCreate inscrit la classe de fenêtre MCIWnd et crée une fenêtre MCIWnd pour l’utilisation des services MCI. MCIWndCreate peut également ouvrir un appareil ou un fichier MCI (tel qu’un fichier AVI) et l’associer à la fenêtre MCIWnd.

Syntaxe

HWND VFWAPIV MCIWndCreateA(
  HWND      hwndParent,
  HINSTANCE hInstance,
  DWORD     dwStyle,
  LPCSTR    szFile
);

Paramètres

hwndParent

Handle vers la fenêtre parente.

hInstance

Gérez le module instance à associer à la fenêtre MCIWnd.

dwStyle

Indicateurs définissant le style de fenêtre. En plus de spécifier les styles de fenêtre utilisés avec la fonction CreateWindowEx , vous pouvez spécifier les styles suivants à utiliser avec les fenêtres MCIWnd.

Valeur	Signification
MCIWNDF_NOAUTOSIZEWINDOW	Ne modifie pas les dimensions d’une fenêtre MCIWnd lorsque la taille de l’image change.
MCIWNDF_NOAUTOSIZEMOVIE	Ne modifie pas les dimensions du rectangle de destination quand une taille de fenêtre MCIWnd change.
MCIWNDF_NOERRORDLG	Empêche l’affichage des erreurs MCI pour les utilisateurs.
MCIWNDF_NOMENU	Masque le bouton Menu de l’affichage dans la barre d’outils et interdit aux utilisateurs d’accéder à son menu contextuel.
MCIWNDF_NOOPEN	Masque les commandes d’ouverture et de fermeture du menu MCIWnd et interdit aux utilisateurs d’accéder à ces options dans le menu contextuel.
MCIWNDF_NOPLAYBAR	Masque la barre d’outils de l’affichage et interdit aux utilisateurs d’y accéder.
MCIWNDF_NOTIFYANSI	Fait en sorte que MCIWnd utilise une chaîne ANSI au lieu d’une chaîne Unicode lors de la notification de la fenêtre parente des modifications du mode appareil. Cet indicateur est utilisé en combinaison avec MCIWNDF_NOTIFYMODE.
MCIWNDF_NOTIFYMODE	Provoque la notification de MCIWnd à la fenêtre parente avec un message MCIWNDM_NOTIFYMODE chaque fois que l’appareil change de mode de fonctionnement. Le paramètre lParam de ce message identifie le nouveau mode, tel que MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS	Amène MCIWnd à notifier la fenêtre parente avec un message MCIWNDM_NOTIFYPOS chaque fois qu’une modification de la position de lecture ou d’enregistrement dans le contenu se produit. Le paramètre lParam de ce message contient la nouvelle position dans le contenu.
MCIWNDF_NOTIFYMEDIA	Provoque l’alerte MCIWnd à la fenêtre parente avec un message MCIWNDM_NOTIFYMEDIA chaque fois qu’un nouvel appareil est utilisé ou qu’un fichier de données est ouvert ou fermé. Le paramètre lParam de ce message contient un pointeur vers le nouveau nom de fichier.
MCIWNDF_NOTIFYSIZE	Provoque la notification de MCIWnd à la fenêtre parente lorsque la taille de la fenêtre MCIWnd change.
MCIWNDF_NOTIFYERROR	Provoque la notification par MCIWnd de la fenêtre parente lorsqu’une erreur MCI se produit.
MCIWNDF_NOTIFYALL	Entraîne l’utilisation de tous les styles de notification de fenêtre MCIWNDF.
MCIWNDF_RECORD	Ajoute un bouton Enregistrer à la barre d’outils et ajoute une commande de nouveau fichier au menu si l’appareil MCI dispose d’une fonctionnalité d’enregistrement.
MCIWNDF_SHOWALL	Entraîne l’utilisation de tous les styles MCIWNDF_SHOW.
MCIWNDF_SHOWMODE	Affiche le mode actuel de l’appareil MCI dans la barre de titre de la fenêtre. Pour obtenir la liste des modes d’appareil, consultez la macro MCIWndGetMode .
MCIWNDF_SHOWNAME	Affiche le nom du fichier de données ou de l’appareil MCI ouvert dans la barre de titre de la fenêtre MCIWnd.
MCIWNDF_SHOWPOS	Affiche la position actuelle dans le contenu de l’appareil MCI dans la barre de titre de la fenêtre.

szFile

Chaîne terminée par null indiquant le nom d’un appareil MCI ou d’un fichier de données à ouvrir.

Valeur retournée

Retourne le handle à une fenêtre MCI en cas de réussite ou zéro dans le cas contraire.

Remarques

Les styles de fenêtre par défaut d’une fenêtre enfant sont WS_CHILD, WS_BORDER et WS_VISIBLE. MCIWndCreate suppose une fenêtre enfant lorsqu’un handle non NULL d’une fenêtre parente est spécifié.

Les styles de fenêtre par défaut d’une fenêtre parente sont WS_OVERLAPPEDWINDOW et WS_VISIBLE. MCIWndCreate suppose une fenêtre parente lorsqu’un handle NULL d’une fenêtre parente est spécifié.

Utilisez le handle de fenêtre retourné par cette fonction pour le handle de fenêtre dans les macros MCIWnd. Si votre application utilise cette fonction, elle n’a pas besoin d’utiliser la fonction MCIWndRegisterClass .

Notes

L’en-tête vfw.h définit MCIWndCreate en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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]
Plateforme cible	Windows
En-tête	vfw.h
Bibliothèque	Vfw32.lib
DLL	Msvfw32.dll

Voir aussi