EngMapFile, fonction (winddi.h)
La fonction EngMapFile crée ou ouvre un fichier et la mappe dans l’espace système.
Syntaxe
ENGAPI PVOID EngMapFile(
[in] LPWSTR pwsz,
[in] ULONG cjSize,
[out] ULONG_PTR *piFile
);
Paramètres
[in] pwsz
Pointeur vers une chaîne terminée par null qui contient le nom complet du fichier à mapper. Un exemple de chaîne de nom de fichier complet est L"\?? \c:\test.dat ».
[in] cjSize
Spécifie le nombre d’octets du fichier à mapper.
[out] piFile
Pointeur vers un emplacement de mémoire qui reçoit un identificateur pour le fichier mappé, à condition que le mappage a réussi. Si le mappage n’a pas réussi, l’emplacement de mémoire reçoit la valeur zéro. Lorsque le fichier mappé doit être libéré, cette valeur doit être transmise à EngUnmapFile.
Valeur retournée
EngMapFile retourne un pointeur vers l’affichage mappé du fichier s’il réussit. Sinon, elle retourne NULL.
Notes
Si le fichier existe déjà, EngMapFile s’ouvre et le mappe pour la lecture/écriture. Si le fichier n’existe pas, EngMapFile crée et le mappe pour la lecture/écriture.
La valeur de cjSize affecte le mappage du fichier comme suit :
- Lorsque cjSize est zéro, GDI mappe le fichier dans son intégralité.
- Lorsque cjSize est supérieur à la taille du fichier, GDI développe le fichier en octets cjSize en taille avant de le mapper en mémoire système. Aucune hypothèse ne doit être faite sur le contenu de la mémoire qui dépasse la taille d’origine du fichier.
- Lorsque cjSize est inférieur à la taille du fichier, GDI tronque le fichier en cjSize en taille avant de le mapper en mémoire système.
Configuration requise
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |