Langage de programmation - C pour OS/2 - Référence de procédures et de fonctions

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 1^er janvier 1980.	Tous
	16	QSV_TIME_HIGH	Cette valeur permet d'indiquer la partie haute 32 bits du temps en seconde depuis le 1^er 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 1^er janvier 1980.	Tous
	16	QSV_TIME_HIGH	Cette valeur permet d'indiquer la partie haute 32 bits du temps en seconde depuis le 1^er 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

Section courante

A propos

Section administrative du site

DosQuerySysInfo