Description

Grâce à cette fonction, il est possible de connaître la présence de Windows, sa version (si supérieur ou égal à 3.0) ainsi que son mode actuel de fonctionnement.

Entrée

Sortie

Remarques

• Windows Millenium ne semble pas détectable avec cette routine et on devra plutôt vérifier la présence d'un DOS version 8.0 (voir Interruption 21h, Fonction 30h).

Description

Cette sous-fonction demande le point d'entrée d'un périphérique virtuel, d'application (API) de Windows.

Entrée

Sortie

Remarques

•   Quelques Windows en mode étendu fournissent des services que les applications peuvent accéder. Par exemple, le périphérique d'affichage virtuel (Virtuel Display Device (VDD)) fournit un API utilisable passant par le «WINOLDAP».
    VTD.386: On peut appeler avec un «CALL FAR» cet périphérique virtuel en utilisant certain paramètre dans des registres tout comme une interruption:

  VTD.386	Fonction 00h	Demande la version

  Description

  Cette fonction demande à le périphérique VTD (Virtual Timer Device) quel est sa version.

  Entrée

  Registre	Description
  AX	0000h

  Sortie

  Registre	Description
  AH	Version (exemple: le 3 de 3.10)
  AL	Sous-Version (exemple: le 10 de 3.10)

  Remarque

  •   Vous ne devriez appeler directement cette fonction que lorsque la fonction «TimerCount» de la bibliothèque «TOOLHELP.DLL» ne peut pas être appelé.

  VTD.386	Fonction 01h	Demande le tic courant d'horloge

  Description

  Cette fonction demande à le périphérique virtuel le nombre de tic d'horloge s'étant produit sur l'horloge gardant l'heure courant 840 nanosecondes après le lancement de Windows.

  Entrée

  Registre	Description
  AX	0100h

  Sortie

  Registre	Description
  EDX:EAX	Nombre d'unité de temps après le lancement de Windows

  Remarque

  •   Vous ne devriez appeler directement cette fonction que lorsque la fonction «TimerCount» de la bibliothèque «TOOLHELP.DLL» ne peut pas être appelé.

  VTD.386	Fonction 01h, Sous-Fonction 01h	Heure système en milliseconde

  Description

  Cette fonction demande l'heure courante du système en millisecondes après que Windows ait été lancés.

  Entrée

  Registre	Description
  AX	0101h

  Sortie

  Registre	Description
  EAX	Temps depuis lequel Windows fonctionne

  Remarque

  • Vous ne devriez appeler directement cette fonction que lorsque la fonction «TimerCount» de la bibliothèque «TOOLHELP.DLL» ne peut pas être appelé.

  VTD.386	Fonction 02h	Demande l'heure machine virtuelle

  Description

  Cette fonction demande l'heure courant machine virtuel quand une accumulation de temps machine virtuelle est monté.

  Entrée

  Registre	Description
  AX	0102h

  Sortie

  Registre	Description
  EAX	Accumulation de temps machine virtuel en millisecondes si l'accumulation est monté.

  Remarque

  • Vous ne devriez appeler directement cette fonction que lorsque fonction «TimerCount» de la bibliothèque «TOOLHELP.DLL» ne peut pas être appelé.
    VADMAD: On peut appeler avec un «CALL FAR» cette device virtuel en utilisant le registre DX pour designer l'opération (DX=0: Fixe le mode VADMAD, DX=1: Fixe le canal VADMAD). Ensuite mettre dans le registre AX le mode ou le canal. Après avoir fixé le mode et le canal, débutez les opérations ou DMA avec une instruction assembleur OUT ou port d'entrée/sortie 0Bh (canal 0 à 3) ou D6h (canal 4 à 7).

Description

Cette sous-fonction permet de connaître le mode de DPMI (DOS Protected Mode Interface) sous lequel l'ordinateur fonctionne.

Entrée

Sortie

Remarques

• Certains environnements prennent en charge des programmes ou des bibliothèques pouvant s'exécuter en mode réel ou mode protégé (code bimodal). Cette fonction est fournie afin que ces programmes puissent détecter au moment de l'exécution s'ils s'exécutent en mode protégé et utiliser les fonctionnalités du système en conséquence.
• Cette fonction ne doit pas être utilisée pour déterminer si un hôte DPMI est présent. Un client doit s'assurer que les services DPMI sont disponibles avant d'appeler cette fonction; sinon, les résultats renvoyés par la fonction peuvent ne pas être valides.

Description

Cette sous-fonction permet de détecter si un gestionnaire DPMI (DOS Protected-Mode Interface) est présent.

Entrée

Sortie

Remarques

• Le point d'entrée renvoyé par l'interruption 2Fh, fonction 1687h n'est appelé que pour le premier commutateur en mode protégé par un client DPMI.
• Sous les hôtes DPMI, le numéro de version principal est renvoyé en DH et le numéro de version mineur est renvoyé en DL. Il existe deux chiffres décimaux pour le numéro de version secondaire, le chiffre le moins significatif représentant le numéro de révision du numéro de version secondaire. Sous les hôtes DPMI version 0.9, le registre DH est renvoyé comme 0 et DL est renvoyé comme décimal 90 (5AH). Dans l'hypothèse d'un DPMI version 2.3, le registre DH serait retourné comme 2 et le registre DL serait retourné comme 30 (1Eh).
• Appelez le point d'entrée avec les paramètres :

Registre	Description
AX	Drapeaux:
	Code	Description
	0	Programmes en 32-bits supporté
	1 à 15	Réservé
ES	Segment en mode réel du tampon pour des données privées du DPMI (ignorée si SI=0)



• Il retournera en fonction du processus les éléments suivant :
• CF=1: Erreur, programme roule en mode réel:
• AX=Code d'erreur (DPMI 1.0+) :

Code d'erreur	Description
8011h	Impossible d'allouer les descripteurs nécessaires
8021h	Lors de l'appelle, une demande en 32-bits a été faite, toutefois, présentement il fonctionne en DPMI 16-bits.

0: Tout va bien, le programme est maintenant en mode protégé:
CS=Sélecteur 16-bits correspondant au CS du mode réel
SS=Sélecteur 16-bits correspondant au SS du mode réel (limite de 64 Ko maximum)
DS=Sélecteur 16-bits correspondant au DS du mode réel (limite de 64 Ko maximum)
ES=Sélecteur du PSP du programme (100h octets maximum)
FS=GS=0
Haut du mot de ESP=0 si le programme fonctionne en 32-bits

• Le point d'entrée est seulement appelé pour initialisé les paramètres au mode protégé.

Description

Cette option permet de définir un nom à l'application d'une longueur maximal de 79 caractères et devant obligatoirement être terminée par un code ASCII 0 ne faisant pas partie du 79 caractères juste-spécifié.

Entrée

Sortie

Remarques

•   Si l'adresse pointée par ES:DI est 0000h:0000h ou qu'elle pointe sur une chaîne de caractères vide, le nom courant est automatiquement détruit.
    BUG: Cette option retourne une opération réussite malgré le fait que le nom n'est pas changé. Afin de résoudre ce problème, il faut attendre deux tics d'horloge après que le programme est démarrer pour obtenir la véritable réponse.

Description

Cette option permet de définir un nouveau nom de machine virtuel d'une longueur maximal de 29 caractères et devant obligatoirement être terminée par un code ASCII 0 ne faisant pas partie du 29 caractères juste nommé.

Entrée

Sortie

Remarques

•   Si l'adresse pointée par ES:DI est 0000h:0000h ou qu'elle pointe sur une chaîne de caractères vide, le nom courant est automatiquement détruit.
    Le nom virtuel de la machine est seulement modifier sous demande explicite de l'utilisateur.
    BUG: Cette option retourne une opération réussite malgré le fait que le nom n'est pas changé. Afin de résoudre ce problème, il faut attendre deux tics d'horloge après que le programme est démarrer pour obtenir la véritable réponse.

Description

Cette option permet de connaître le nom de l'application en le copiant si possible dans le tampon spécifier après l'avoir terminé par un code ASCII 0 comme une chaîne de caractères de format ASCIZ.

Entrée

Sortie

Description

Cette option permet de copier le nom de la machine virtuel si possible dans le tampon spécifier après l'avoir terminé par un code ASCII 0 comme une chaîne de caractères de format ASCIZ.

Entrée

Sortie