DosQuerySysInfo |
DOS : Requête d'information système |
|---|---|
| DOSCALLS.DLL | os2.h |
Syntaxe
| APIRET DosQuerySysInfo( ULONG ulStartIndex, ULONG ulLastIndex, PVOID pDataBuffer, LONG ulDataBufferLength ); |
Paramètres
| Nom | Description | |||
|---|---|---|---|---|
| ulStartIndex | Ce paramètre permet d'indiquer l'index du premier information de requête. Les valeurs d'index valides pour se paramètre sont : | |||
| Valeur d'index | Nom | Description | Version | |
| 1 | QSV_MAX_PATH_LENGTH | Cette valeur permet d'indiquer la longueur maximal du nom d'un chemin en octets. Utilisé lorsqu'il y a une allocation d'un tampon de nom de fichiers. | Tous | |
| 2 | QSV_MAX_TEXT_SESSIONS | Cette valeur permet d'indiquer le nombre maximal de sessions texte. | Tous | |
| 3 | QSV_MAX_PM_SESSIONS | Cette valeur permet d'indiquer le nombre maximal de sessions avec le gestionnaire de présentation. | Tous | |
| 4 | QSV_MAX_VDM_SESSIONS | Cette valeur permet d'indiquer le nombre maximal de sessions DOS. | Tous | |
| 5 | QSV_BOOT_DRIVE | Cette valeur permet d'indiquer l'unité de démarrage : 1 = A, 2 = B, 3 = C, 4 = D,... | Tous | |
| 6 | QSV_DYN_PRI_VARIATION | Cette valeur permet d'indiquer le type de priorité : 0 = absolue, 1 = dynamique. | Tous | |
| 7 | QSV_MAX_WAIT | Cette valeur permet d'indiquer le délai maximal d'attente en secondes. | Tous | |
| 8 | QSV_MIN_SLICE | Cette valeur permet d'indiquer la tranche de temps minimum alloué en milliseconde. | Tous | |
| 9 | QSV_MAX_SLICE | Cette valeur permet d'indiquer la tranche de temps maximum alloué en milliseconde. | Tous | |
| 10 | QSV_PAGE_SIZE | Cette valeur permet d'indiquer la taille de page mémoire en octets. La valeur par défaut est 4096 octets. | Tous | |
| 11 | QSV_VERSION_MAJOR | Cette valeur permet d'indiquer le numéro de version majeur. | Tous | |
| 12 | QSV_VERSION_MINOR | Cette valeur permet d'indiquer le numéro de version mineur. | Tous | |
| 13 | QSV_VERSION_REVISION | Cette valeur permet d'indiquer la lettre de révision. | Tous | |
| 14 | QSV_MS_COUNT | Cette valeur permet d'indiquer la valeur d'un compteur de millisecondes en 32 bits. Il vaut 0 lors de démarrage du système d'exploitation. | Tous | |
| 15 | QSV_TIME_LOW | Cette valeur permet d'indiquer la partie basse 32 bits du temps en seconde depuis le 1er janvier 1980. | Tous | |
| 16 | QSV_TIME_HIGH | Cette valeur permet d'indiquer la partie haute 32 bits du temps en seconde depuis le 1er janvier 1980. | Tous | |
| 17 | QSV_TOTPHYSMEM | Cette valeur permet d'indiquer le nombre total d'octets dans la mémoire physique. | Tous | |
| 18 | QSV_TOTRESMEM | Cette valeur permet d'indiquer le nombre total d'octets dans la mémoire résidente du système d'exploitation. | Tous | |
| 19 | QSV_TOTAVAILMEM | Cette valeur permet d'indiquer le nombre maximum d'octets de disponible pour tous les processus dans le système maintenant. | Tous | |
| 20 | QSV_MAXPRMEM | Cette valeur permet d'indiquer le nombre maximum d'octets de disponible pour ce processus maintenant. | Tous | |
| 21 | QSV_MAXSHMEM | Cette valeur permet d'indiquer le nombre d'octets partagé de disponible maintenant. | Tous | |
| 22 | QSV_TIMER_INTERVAL | Cette valeur permet d'indiquer l'intervalle de la minuterie en 1/10 millisecondes. | Tous | |
| 23 | QSV_MAX_COMP_LENGTH | Cette valeur permet d'indiquer la longueur maximal d'une composante dans un chemin de fichier en octets. | Tous | |
| 24 | QSV_FOREGROUND_FS_SESSION | Cette valeur permet d'indiquer l'identificateur de session de la session plein écran de premier plan. N'importe quel session de gestionnaire de présentation, VIO ou Win-DOS doit avoir un identificateur = 1. | OS/2 Warp | |
| 25 | QSV_FOREGROUND_PROCESS | Cette valeur permet d'indiquer l'identificateur de processus du processus courant de premier plan. | OS/2 Warp | |
| 26 | QSV_NUMPROCESSORS | Cette valeur permet d'indiquer le nombre de microprocesseur que possède cette ordinateur. | OS/2 Warp | |
| ulLastIndex | Ce paramètre permet d'indiquer l'index du dernière information de requête. Ce paramètre est égale à ulStartIndex pour indiquer une seule information de valeur d'index. Les valeurs d'index valides pour se paramètre sont : | |||
| Valeur d'index | Nom | Description | Version | |
| 1 | QSV_MAX_PATH_LENGTH | Cette valeur permet d'indiquer la longueur maximal du nom d'un chemin en octets. Utilisé lorsqu'il y a une allocation d'un tampon de nom de fichiers. | Tous | |
| 2 | QSV_MAX_TEXT_SESSIONS | Cette valeur permet d'indiquer le nombre maximal de sessions texte. | Tous | |
| 3 | QSV_MAX_PM_SESSIONS | Cette valeur permet d'indiquer le nombre maximal de sessions avec le gestionnaire de présentation. | Tous | |
| 4 | QSV_MAX_VDM_SESSIONS | Cette valeur permet d'indiquer le nombre maximal de sessions DOS. | Tous | |
| 5 | QSV_BOOT_DRIVE | Cette valeur permet d'indiquer l'unité de démarrage : 1 = A, 2 = B, 3 = C, 4 = D,... | Tous | |
| 6 | QSV_DYN_PRI_VARIATION | Cette valeur permet d'indiquer le type de priorité : 0 = absolue, 1 = dynamique. | Tous | |
| 7 | QSV_MAX_WAIT | Cette valeur permet d'indiquer le délai maximal d'attente en secondes. | Tous | |
| 8 | QSV_MIN_SLICE | Cette valeur permet d'indiquer la tranche de temps minimum alloué en milliseconde. | Tous | |
| 9 | QSV_MAX_SLICE | Cette valeur permet d'indiquer la tranche de temps maximum alloué en milliseconde. | Tous | |
| 10 | QSV_PAGE_SIZE | Cette valeur permet d'indiquer la taille de page mémoire en octets. La valeur par défaut est 4096 octets. | Tous | |
| 11 | QSV_VERSION_MAJOR | Cette valeur permet d'indiquer le numéro de version majeur. | Tous | |
| 12 | QSV_VERSION_MINOR | Cette valeur permet d'indiquer le numéro de version mineur. | Tous | |
| 13 | QSV_VERSION_REVISION | Cette valeur permet d'indiquer la lettre de révision. | Tous | |
| 14 | QSV_MS_COUNT | Cette valeur permet d'indiquer la valeur d'un compteur de millisecondes en 32 bits. Il vaut 0 lors de démarrage du système d'exploitation. | Tous | |
| 15 | QSV_TIME_LOW | Cette valeur permet d'indiquer la partie basse 32 bits du temps en seconde depuis le 1er janvier 1980. | Tous | |
| 16 | QSV_TIME_HIGH | Cette valeur permet d'indiquer la partie haute 32 bits du temps en seconde depuis le 1er janvier 1980. | Tous | |
| 17 | QSV_TOTPHYSMEM | Cette valeur permet d'indiquer le nombre total d'octets dans la mémoire physique. | Tous | |
| 18 | QSV_TOTRESMEM | Cette valeur permet d'indiquer le nombre total d'octets dans la mémoire résidente du système d'exploitation. | Tous | |
| 19 | QSV_TOTAVAILMEM | Cette valeur permet d'indiquer le nombre maximum d'octets de disponible pour tous les processus dans le système maintenant. | Tous | |
| 20 | QSV_MAXPRMEM | Cette valeur permet d'indiquer le nombre maximum d'octets de disponible pour ce processus maintenant. | Tous | |
| 21 | QSV_MAXSHMEM | Cette valeur permet d'indiquer le nombre d'octets partagé de disponible maintenant. | Tous | |
| 22 | QSV_TIMER_INTERVAL | Cette valeur permet d'indiquer l'intervalle de la minuterie en 1/10 millisecondes. | Tous | |
| 23 | QSV_MAX_COMP_LENGTH | Cette valeur permet d'indiquer la longueur maximal d'une composante dans un chemin de fichier en octets. | Tous | |
| 24 | QSV_FOREGROUND_FS_SESSION | Cette valeur permet d'indiquer l'identificateur de session de la session plein écran de premier plan. N'importe quel session de gestionnaire de présentation, VIO ou Win-DOS doit avoir un identificateur = 1. | OS/2 Warp | |
| 25 | QSV_FOREGROUND_PROCESS | Cette valeur permet d'indiquer l'identificateur de processus du processus courant de premier plan. | OS/2 Warp | |
| 26 | QSV_NUMPROCESSORS | Cette valeur permet d'indiquer le nombre de microprocesseur que possède cette ordinateur. | OS/2 Warp | |
| pDataBuffer | Ce paramètre permet d'indiquer l'adresse d'un tampon de données dans lequel il faut mettre les informations. | |||
| ulDataBufferLength | Ce paramètre permet d'indiquer la taille du paramètre pDataBuffer. | |||
Retour
| Valeur | Constante | Description |
|---|---|---|
| 0 | NO_ERROR | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
| 87 | ERROR_INVALID_PARAMETER | Cette valeur permet d'indiquer qu'un ou plusieurs des paramètres contient une valeur illégale. |
| 111 | ERROR_BUFFER_OVERFLOW | Cette valeur permet d'indiquer qu'un débordement du tampon s'est produit. |
Description
Cette fonction permet d'envoyer un requête de différentes informations à propos du système et retourne le contenu dans un tampon après l'appel.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_DOSERRORS
- #define INCL_DOSMISC
- #include "os2.h"
- #include "stdio.h"
-
- void main(void) {
- ULONG buffer[3];
- switch(DosQuerySysInfo(QSV_VERSION_MAJOR, QSV_VERSION_REVISION, (void *)buffer, sizeof(buffer))) {
- case NO_ERROR: printf("Version %d.%d révision %c.\n", buffer[0], buffer[1], (char) buffer[2]);break;
- case ERROR_INVALID_PARAMETER: printf("Erreur : Un ou plusieurs des paramètres contient une valeur illégale.");break;
- case ERROR_BUFFER_OVERFLOW: printf("Erreur : Un débordement du tampon s'est produit.");break;
- }
- }
Voir également
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010