Interruption 21h |
Fonction 12h |
Rechercher l'entrée suivante d'un répertoire par le FCB |
|---|---|---|
| CP/M, DOS 1.0+, OS/2, Windows NT | ||
Description
Cette fonction permet de rechercher l'entrée suivante d'un répertoire en utilisant l'ancienne méthode du FCB (File Control Block).
Entrée
| Registre | Valeur ou description | ||
|---|---|---|---|
| AH | 12h | ||
| DS:DX | Cette paire de registres permet d'indiquer l'adresse du tampon FCB du fichier. Vous pouvez utiliser le bloc de FCB normal : | ||
| Déplacement | Longueur | Description | |
| 00h | 1 octet | Ce champ contient l'unité (0 = unité courante, 1=A:, 2=B:, 3=C:, 4=D:,...) | |
| 01h | 8 octets | Ce champ contient le nom du fichier avec des espaces s'il n'est pas assez long | |
| 09h | 3 octets | Ce champ contient l'extension du fichier avec des espaces s'il n'est pas assez long | |
| 0Ch | 2 octets (1 mot) | Ce champ contient le numéro du bloc courant | |
| 0Eh | 2 octets (1 mot) | Ce champ contient la taille de l'enregistrement | |
| 10h | 4 octets (2 mots) | Ce champ contient la taille du fichier | |
| 14h | 2 octets (1 mot) | Ce champ contient la date de la dernière modification | |
| 16h | 2 octets (1 mot) | Ce champ contient l'heure de la dernière modification | |
| 18h | 8 octets | Ce champ est réservé pour un usage interne ou futur | |
| 20h | 1 octet | Ce champ contient le numéro de l'enregistrement courant | |
| 21h | 4 octets | Ce champ contient le numéro de l'enregistrement pour l'accès séquentiel | |
| ou le bloc de FCB étendue : | |||
| Déplacement | Longueur | Description | |
| 00h | 1 octet | Ce champ contient un identificateur de FCB étendu (FFh) | |
| 01h | 5 octets | Ce champ est réservé pour un usage interne ou futur | |
| 06h | 1 octet | Ce champ contient les attributs de fichier | |
| 07h | 1 octet | Ce champ contient l'unité (0 = unité courante, 1=A:, 2=B:, 3=C:, 4=D:,...) | |
| 08h | 8 octets | Ce champ contient le nom du fichier avec des espaces s'il n'est pas assez long | |
| 10h | 3 octets | Ce champ contient l'extension du fichier avec des espaces s'il n'est pas assez long | |
| 13h | 2 octets (1 mot) | Ce champ contient le numéro du bloc courant | |
| 15h | 2 octets (1 mot) | Ce champ contient la taille de l'enregistrement | |
| 17h | 4 octets (2 mots) | Ce champ contient la taille du fichier | |
| 1Bh | 2 octets (1 mot) | Ce champ contient la date de la dernière modification | |
| 1Dh | 2 octets (1 mot) | Ce champ contient l'heure de la dernière modification | |
| 1Fh | 8 octets | Ce champ est réservé pour un usage interne ou futur | |
| 27h | 1 octet | Ce champ contient le numéro de l'enregistrement courant | |
| 28h | 4 octets | Ce champ contient le numéro de l'enregistrement pour l'accès séquentiel | |
Sortie
| Registre | Valeur ou description | |
|---|---|---|
| AL | Ce registre permet d'indiquer le résultat de l'opération : | |
| Valeur | Description | |
| 0 | Une entrée de fichier a été trouvé | |
| 255 | Aucune entrée de fichier n'a été trouvé | |
Remarques
- Cette fonction suppose que le FCB utilisé en entrée a été correctement initialisé par un appel précédent à l'interruption 21h, fonction 11h (et les éventuels appels ultérieurs à l'interruption 21h, fonction 12h) et que le nom de fichier ou l'extension recherché contenait au moins un caractère générique.
- Comme avec l'interruption 21h, fonction 11h, il est important d'utiliser l'interruption 21h, fonction 1Ah pour définir le DTA sur un tampon de taille adéquate avant d'appeler cette fonction.
- A partir de la version 2.0 du système d'exploitation DOS, les fonctions 4Eh et fonctions 4Fh de l'interruption 21h, permettent un accès complet à la structure de répertoire hiérarchique, doivent être utilisées de préférence à cette fonction.
Références
La Bible du PC: Programmation système - Sixième Edition, Edition Micro-Application, Michael Tischer, 1996, ISBN: 2-7429-0544-8, page 1502.
Aide-mémoire des interruptions du MS-DOS, Edition Marabout, Philippe Mercier, 1990, ISBN: 2-501-01297-6, page 146 à 147.
Quick Reference: Programmer avec les fonctions de MS-DOS, Edition Microsoft PRESS, Ray Duncan, 1991, ISBN: 2-266-04061-8, page 27 à 28.
Dernière mise à jour : Jeudi, le 3 mars 2016