Connexion

Select the product you need help with

Comment faire pour utiliser les fonctions VDMDBG sur Windows NT, Windows 2000 et Windows XP

Num�ro d'article: 182559 - Voir les produits auxquels s'applique cet article

ATTENTION : Cet article est issu du syst�me de traduction automatique

Cliquez ici si vous souhaitez afficher en c�te � c�te l?article anglais et sa traduction automatique en fran�ais

Agrandir tout | R�duire tout

M�me lorsque vous programmez dans un environnement 32 bits, il est parfois travailler avec des applications 16 bits n�cessaire. Dans Windows NT, les applications 16 bits s'ex�cutent au sein d'une machine virtuelle DOS (VDM). VDMDBG.dll contient des nombreuses fonctions qui sont utiles pour travailler avec des applications 16 bits. Cette biblioth�que fait partie du Kit de d�veloppement.

Fonctions VDMDBG permettent une bonne pour �num�rer, cr�er et mettre fin aux processus 16 bits (t�ches) au sein d'un VDM. Cet article d�crit comment utiliser ces fonctions sur Microsoft Windows NT, Windows 2000 et Windows XP.

Retour au d�but | Envoyer des commentaires

Plus d'informations

Lorsque vous utilisez une des fonctions VDMDBG, vous devez cr�er un lien VDMDBG.lib avec votre projet.

Les fonctions VDMDBG mentionn�es ci-dessous ne sont qu'un sous-ensemble des fonctions disponibles. Toutefois, les fonctions qui ne sont pas mentionn�es concernent uniquement un d�bogueur.

L'�num�ration des VDM

La fonction VDMEnumProcessWOW() offre un moyen simple pour �num�rer tous les VDM 16 bits Windows t�ches en cours d'ex�cution. Ces VDM contient la t�che WowExec.exe. Les VDM DOS ne sont pas �num�r�s.

La d�claration pour cette fonction est la suivante :

   INT WINAPI VDMEnumProcessWOW( PROCESSENUMPROC fp, LPARAM lparam );

la valeur renvoy�e pour cette fonction est le nombre de VDM en cours d'ex�cution ou l'�num�ration �num�r�e avant le num�rique a �t� interrompue. fp est un pointeur vers une fonction de rappel. La fonction est appel�e pour chaque VDM est �num�r�. lParam est une valeur d�finie par l'utilisateur qui est pass�e � la fonction de rappel.

PROCESSENUMPROC est d�clar�e comme suit :

   typedef BOOL ( WINAPI *PROCESSENUMPROC )(
      DWORD dwProcessId,
      DWORD dwAttributes,
      LPARAM lpUserDefined
   );

la fonction doit retourner TRUE pour �num�ration stop ou FALSE pour continuer l'�num�ration. dwProcessId est l'ID du processus du processus NTVDM.exe. Vous aurez besoin ce code lors de l'appel des fonctions VDM mentionn�es ci-dessous.

L'�num�ration des t�ches de Windows 16 bits

Vous pouvez utiliser VDMEnumTaskWOW() et VDMEnumTaskWOWEx() pour �num�rer les t�ches au sein d'un VDM donn�. La diff�rence entre les deux est que VDMEnumTaskWOWEx() fournit des informations suppl�mentaires � la fonction de rappel. Vous ne devez utiliser VDM retourn�es par VDMEnumProcessWOW() avec ces fonctions d'�num�ration de t�che. � l'aide de VDM DOS n'a pas de sens car chaque application DOS s'ex�cute dans son propre VDM.

Les d�clarations sont :

   INT WINAPI VDMEnumTaskWOW( DWORD dwProcessId, TASKENUMPROC fp,
                              LPARAM lparam );

   INT WINAPI VDMEnumTaskWOWEx( DWORD dwProcessId, TASKENUMPROCEX fp,
                                LPARAM lparam );

la valeur renvoy�e pour chacune de ces fonctions est le nombre de t�ches en cours d'ex�cution au sein de VDM indiqu�e ou de l'�num�ration �num�r�e avant le num�rique a �t� interrompue. dwProcessId est l'ID de processus du fp VDM est un pointeur vers une fonction de rappel. La fonction est appel�e pour chaque t�che est �num�r�. lParam est une valeur d�finie par l'utilisateur qui est pass�e � la fonction de rappel.

TASKENUMPROC et TASKENUMPROCEX sont d�finis comme suit :

   typedef BOOL ( WINAPI *TASKENUMPROC )(
      DWORD dwThreadId,
      WORD hMod16,
      WORD hTask16,
      LPARAM lpUserDefined
   );

   typedef BOOL ( WINAPI *TASKENUMPROCEX )(
      DWORD dwThreadId,
      WORD hMod16,
      WORD hTask16,
      PSZ pszModName,
      PSZ pszFileName,
      LPARAM lpUserDefined
   );

ces fonctions doivent r�tablir vrai �num�ration stop ou FALSE pour continuer l'�num�ration. Vous pouvez utiliser hTask16 dans un appel pour terminer la t�che.

Exemple d'�num�ration

   // Enumerate all 16-bit tasks on the system.
   #include <windows.h>
   #include <stdio.h>
   #include <vdmdbg.h>

   BOOL WINAPI ProcessEnumProc( DWORD, DWORD, LPARAM );
   BOOL WINAPI TaskEnumProcEx( DWORD, WORD, WORD, PSZ, PSZ, LPARAM );

   void main()
   {
      // Enumerate VDMs.
      VDMEnumProcessWOW(
         (PROCESSENUMPROC)ProcessEnumProc,
         (LPARAM)NULL
      );

   }

   BOOL WINAPI ProcessEnumProc( DWORD dwProcessId, DWORD dwAttrib,
      LPARAM t )
   {
      printf("\nProcess ID: %d\n", dwProcessId);

      // Use process ID of VDM to enumerate through its tasks.
      VDMEnumTaskWOWEx(
         dwProcessId,
         (TASKENUMPROCEX)TaskEnumProcEx,
         (LPARAM)NULL
      );

      // Keep enumerating.
      return FALSE;
   }

   BOOL WINAPI TaskEnumProcEx( DWORD dwThreadId, WORD hMod16, WORD hTask16,
      PSZ pszModName, PSZ pszFileName, LPARAM lParam )
   {
      //print task's information
      printf("Thread ID: %d\n", dwThreadId);
      printf("Module handle: %d\n", hMod16);
      printf("Task handle: %d\n", hTask16);
      printf("Module Name: %s\n", pszModName);
      printf("File Name: %s\n", pszFileName);

      // Keep enumerating.
      return FALSE;
   }

Cr�ation de t�ches de 16 bits

VDMStartTaskInWOW() cr�e une t�che dans un VDM. La d�claration est la suivante :

   BOOL WINAPI VDMStartTaskInWOW( DWORD dwProcessId, LPSTR lpCommandLine,
                                  WORD wShow );

la valeur de retour de cette fonction est TRUE si la t�che est d�marr�e avec succ�s, sinon c'est faux. dwProcessId est l'ID du processus VDM. lpCommandLine est une cha�ne qui indique le nom de fichier de l'application 16 bits avec les param�tres de la ligne de commande. wShow indique comment la fen�tre est affich�e. wShow peut �tre n'importe quelle valeur valide pour la fonction ShowWindow() 16 bits.

Arr�t de t�ches de 16 bits

Pour terminer une t�che au sein d'un appel VDM VDMTerminateTaskWOW(). La d�claration est la suivante :

   BOOL WINAPI VDMTerminateTaskWOW( DWORD dwProcessId, WORD htask );

la valeur de retour de cette fonction est TRUE si la t�che est termin�e avec succ�s, sinon c'est faux. dwProcessId est le hTask ID. de processus VDM constitue le handle de la t�che. Ce handle de t�che peut �tre obtenu via VDMEnumTaskWOW() ou VDMEnumTaskWOWEx().

Cette m�thode est �quivalent � TerminateProcess() dans Win32. Il convient d'�viter, si possible. Il ne fournit pas la t�che une chance de sortie correctement, donn�es peuvent �tre perdues. Contrairement � Win32, le WowExec n'est pas garanti de nettoyer apr�s une t�che arr�t�e. Cela peut laisser le VDM endommag�e et inutilisable. Pour terminer la t�che proprement, envoyez un message WM_CLOSE � sa fen�tre de niveau sup�rieur.

Remarque concernant les applications de DOS 16 bits

Aucune des fonctions VDMDBG de manipuler les applications de DOS 16 bits. Pour �num�rer les VDM DOS, vous devez utiliser une autre m�thode. Tout d'abord, vous pouvez �galement utiliser VDMEnumProcessWOW() pour cr�er une liste de tous les VDM Win16 et puis �num�rer toutes les instances de NTVDM.exe � l'aide de certains autre sch�ma (tel que PSAPI). Tout NTVDM.exe � partir de l'�num�ration compl�te qui n'�tait pas dans la liste de Win16 est un VDM DOS. Vous pouvez cr�er et terminer des applications de DOS 16 bits avec CreateProcess() et TerminateProcess().

Retour au d�but | Envoyer des commentaires

Propri�t�s

Num�ro d'article: 182559 - Derni�re mise � jour: mardi 21 novembre 2006 - Version: 3.4

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Microsoft Win32 Application Programming Interface�sur le syst�me suivant

Microsoft Windows NT 4.0
the operating system: Microsoft Windows 2000
the operating system: Microsoft Windows XP

kbmt kbapi kbhowto kbkernbase kbthread KB182559 KbMtfr

Traduction automatique

IMPORTANT : Cet article est issu du syst�me de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis � votre disposition en compl�ment des articles traduits en langue fran�aise par des traducteurs professionnels. Cela vous permet d?avoir acc�s, dans votre propre langue, � l?ensemble des articles de la base de connaissances r�dig�s originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne �trang�re s?exprimant dans votre langue !). N�anmoins, mis � part ces imperfections, ces articles devraient suffire � vous orienter et � vous aider � r�soudre votre probl�me. Microsoft s?efforce aussi continuellement de faire �voluer son syst�me de traduction automatique.

La version anglaise de cet article est la suivante: 182559

(http://support.microsoft.com/kb/182559/en-us/ )

L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Retour au d�but | Envoyer des commentaires