Interruption 21h |
Fonction 5Fh, Sous-fonction 03h |
Redirection d'un périphérique |
|---|---|---|
| DOS 3.1+ et Share, OS/2, Windows NT | ||
Description
Cette fonction permet la redirection d'un périphérique.
Entrée
| Registre | Valeur ou description | |
|---|---|---|
| AX | 5F03h | |
| BL | Ce registre permet d'indiquer le type de périphérique: | |
| Valeur | Description | |
| 03h | Ce type de périphérique indique une imprimante | |
| 04h | Ce type de périphérique indique une unité disque | |
| CX | Ce registre permet d'indiquer la signature du pilote: | |
| Valeur | Description | |
| 0000h | Ce code indique un pilote LANtastic | |
| 4E57h ('NW') | Ce code indique un pilote NetWare | |
| DS:SI | Cette paire de registres permet d'indiquer l'adresse du tampon de 16 octets contenant le nom d'un périphérique local sous forme d'une chaine de caractères ASCIZ. | |
| ES:DI | Cette paire de registres permet d'indiquer l'adresse du tampon de 128 octets contenant le nom du réseau, suivi du mot de passe sous forme d'une chaine de caractères ASCIZ | |
Sortie
| Registre | Valeur ou description | |||
|---|---|---|---|---|
| FC | Ce registre de drapeau de retenue permet d'indiquer le résultat de l'opération : | |||
| Valeur | Description | |||
| 0 | Cette valeur permet d'indiquer que l'opération a été un succès | |||
| 1 | Cette valeur permet d'indiquer une erreur, dans ce cas : | |||
| Registre | Description | |||
| AX | Ce registre permet d'indiquer le code d'erreur : | |||
| Valeur | Description | |||
| 01h | Cette erreur permet d'indiquer que le numéro de la fonction n'est pas valide | |||
| 03h | Cette erreur permet d'indiquer que le chemin est introuvable | |||
| 05h | Cette erreur permet d'indiquer que l'accès est refusé | |||
| 08h | Cette erreur permet d'indiquer que la mémoire disponible est insuffisante | |||
| 0Fh | Cette erreur permet d'indiquer que le lecteur (unité) est inconnu | |||
| 12h | Cette erreur permet d'indiquer qu'il n'y a plus d'autres fichiers dans la liste | |||
Remarques
- Le nom local peut être un indicateur de l'unité de disque (une lettre suivie de deux points, comme «D:»), un nom d'imprimante ou une chaîne de caractères nulle. Les noms d'imprimante doivent être l'un des suivants : PRN, LPT1, LPT2 ou LPT3. Si une chaîne de caractères nulle suivie d'un mot de passe est utilisée, le système d'exploitation DOS tente d'accorder l'accès au répertoire réseau avec le mot de passe spécifié.
- Le paramètre transmis dans le registre CX peut être récupéré par des appels ultérieurs de l'interruption 21h, fonction 5Fh, sous-fonction 02h. Il représente des données privées pour les applications les entreposant et les récupérant et n'ayant aucune signification pour DOS.
Références
Aide-mémoire des interruptions du MS-DOS, Edition Marabout, Philippe Mercier, 1990, ISBN: 2-501-01297-6, page 289 à 291.
Dernière mise à jour : Jeudi, le 3 mars 2016