En entrée | |
---|---|
R0 | 14 |
R1 | Pointeur vers un Mode Selector Block |
R2 | Pointeur vers une zone mémoire pour recevoir la chaîne de Descripteur de mode |
R3 | 0 ou la taille de la zone mémoire en octets |
En sortie | |
---|---|
R0 | L’erreur retournée, ou inchangé |
R3 | Inférieur à 0: Taille nécessaire pour la zone mémoire |
0: Le Descripteur de mode a été généré | |
- | Tous les autres registres sont inchangés |
Cet appel permet de convertir une Mode Selector Block en Descripteur de mode.
Pour connaitre la taille de la zone mémoire nécessaire, réalisez une première fois l’appel en fournissant 0 dans R3. Dans ce cas précis, l’appel retournera dans R3 une valeur négative. Allouez alors une zone mémoire de -R3 octets pour recevoir la chaîne du Descripteur de mode.
Notes que le Descripteur de mode est moins précis que le Mode Selector Block. Certaines données peuvent donc être perdue au cour de la conversion.
Cet appel est disponible sur RISC OS Select et à partir de RISC OS 5.21.