MapViewOfFile, fonction (memoryapi.h)

Mappe une vue d’un mappage de fichiers dans l’espace d’adressage d’un processus appelant.

Pour spécifier une adresse de base suggérée pour la vue, utilisez la fonction MapViewOfFileEx. Toutefois, cette pratique n’est pas recommandée.

Syntaxe

LPVOID MapViewOfFile(
  [in] HANDLE hFileMappingObject,
  [in] DWORD  dwDesiredAccess,
  [in] DWORD  dwFileOffsetHigh,
  [in] DWORD  dwFileOffsetLow,
  [in] SIZE_T dwNumberOfBytesToMap
);

Paramètres

[in] hFileMappingObject

Handle d’un objet de mappage de fichiers. Les fonctions CreateFileMapping et OpenFileMapping retournent ce handle.

[in] dwDesiredAccess

Type d’accès à un objet de mappage de fichiers, qui détermine la protection des pages. Ce paramètre peut être l’une des valeurs suivantes, ou une combinaison OR au niveau du bit de plusieurs valeurs, le cas échéant.

À l’aide d’or au niveau du bit, vous pouvez combiner les valeurs ci-dessus avec ces valeurs.

Pour les objets de mappage de fichiers créés avec l’attribut SEC_IMAGE, le paramètre dwDesiredAccess n’a aucun effet et doit être défini sur n’importe quelle valeur valide telle que FILE_MAP_READ.

Pour plus d’informations sur l’accès aux objets de mappage de fichiers, consultez sécurité de mappage de fichiers et droits d’accès.

[in] dwFileOffsetHigh

Un ordre élevé DWORD du décalage de fichier où commence la vue.

[in] dwFileOffsetLow

Un ordre faible DWORD du décalage de fichier où l’affichage doit commencer. La combinaison des décalages élevés et faibles doit spécifier un décalage dans le mappage de fichiers. Ils doivent également correspondre à la granularité d’allocation de mémoire virtuelle du système. Autrement dit, le décalage doit être un multiple de la granularité d’allocation VirtualAlloc. Pour obtenir la granularité d’allocation de mémoire VirtualAlloc du système, utilisez la fonction GetSystemInfo, qui remplit les membres d’une structure SYSTEM_INFO.

[in] dwNumberOfBytesToMap

Nombre d’octets d’un mappage de fichier à mapper à la vue. Tous les octets doivent être au sein de la taille maximale spécifiée par CreateFileMapping. Si ce paramètre est égal à 0 (zéro), le mappage s’étend du décalage spécifié à la fin du mappage de fichiers.

Valeur de retour

Si la fonction réussit, la valeur de retour est l’adresse de départ de la vue mappée.

Si la fonction échoue, la valeur de retour est NULL . Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Le mappage d’un fichier rend la partie spécifiée d’un fichier visible dans l’espace d’adressage du processus appelant.

Pour les fichiers dont la taille est supérieure à l’espace d’adressage, vous ne pouvez mapper qu’une petite partie des données de fichier à la fois. Une fois la première vue terminée, vous pouvez la démapper et mapper une nouvelle vue.

Pour obtenir la taille d’une vue, utilisez la fonction VirtualQuery.

Plusieurs vues d’un fichier (ou d’un objet de mappage de fichiers et de son fichier mappé) sont cohérentes s’ils contiennent des données identiques à un moment spécifié. Cela se produit si les vues de fichiers sont dérivées d’un objet de mappage de fichiers soutenu par le même fichier. Un processus peut dupliquer un handle d’objet de mappage de fichiers dans un autre processus à l’aide de la fonction DuplicateHandle , ou un autre processus peut ouvrir un objet de mappage de fichiers par nom à l’aide de la fonction OpenFileMapping.

À une exception importante, les vues de fichiers dérivées d’un objet de mappage de fichiers soutenu par le même fichier sont cohérentes ou identiques à un moment spécifique. La cohérence est garantie pour les vues au sein d’un processus et pour les vues mappées par différents processus.

L’exception est liée aux fichiers distants. Bien que MapViewOfFile fonctionne avec des fichiers distants, il ne les maintient pas cohérents. Par exemple, si deux ordinateurs mappent un fichier en écriture et modifient la même page, chaque ordinateur ne voit que ses propres écritures dans la page. Lorsque les données sont mises à jour sur le disque, elles ne sont pas fusionnées.

Une vue mappée d’un fichier n’est pas garantie d’être cohérente avec un fichier accessible par le ReadFile ou fonction WriteFile.

Ne stockez pas de pointeurs dans le fichier mappé en mémoire ; stockez les décalages de la base du mappage de fichiers afin que le mappage puisse être utilisé à n’importe quelle adresse.

Pour vous protéger contre les exceptions EXCEPTION_IN_PAGE_ERROR, utilisez la gestion des exceptions structurées pour protéger tout code qui écrit ou lit à partir d’une vue mappée en mémoire d’un fichier autre que le fichier de page. Pour plus d’informations, consultez lecture et écriture à partir d’une vue de fichier.

Lors de la modification d’un fichier via une vue mappée, le dernier horodatage de modification peut ne pas être mis à jour automatiquement. Si nécessaire, l’appelant doit utiliser SetFileTime pour définir l’horodatage.

Si un objet de mappage de fichiers est soutenu par le fichier de pagination (CreateFileMapping est appelé avec le paramètre hFile défini sur INVALID_HANDLE_VALUE), le fichier de pagination doit être suffisamment volumineux pour contenir l’intégralité du mappage. Si ce n’est pas le cas, MapViewOfFile échoue. Le contenu initial des pages d’un objet de mappage de fichiers soutenu par le fichier de pagination est égal à 0 (zéro).

Lorsqu’un objet de mappage de fichiers sauvegardé par le fichier de pagination est créé, l’appelant peut spécifier si MapViewOfFile doit réserver et valider des pages en même temps (SEC_COMMIT) ou simplement réserver des pages (SEC_RESERVE). Le mappage du fichier rend la plage d’adresses virtuelles mappée entière indisponible à d’autres allocations dans le processus. Une fois qu’une page de la plage réservée est validée, elle ne peut pas être libérée ou validée en appelant VirtualFree. Les pages réservées et validées sont publiées lorsque la vue n’est pas mappée et que l’objet de mappage de fichiers est fermé. Pour plus d’informations, consultez les fonctions UnmapViewOfFile et CloseHandle.

Pour disposer d’un fichier disposant d’autorisations exécutables, une application doit appeler CreateFileMapping avec PAGE_EXECUTE_READWRITE ou PAGE_EXECUTE_READ, puis appeler MapViewOfFile avec FILE_MAP_EXECUTE | FILE_MAP_WRITE ou FILE_MAP_EXECUTE | FILE_MAP_READ.

Dans Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Lorsque csvFs est suspendu, cet appel peut échouer avec une erreur indiquant qu’il existe un conflit de verrous.

Exemples

Pour obtenir un exemple, consultez Création d’unede mémoire partagée nommée .

Exigences

Voir aussi

CreateFileMapping

création d’un d’affichage de fichiers

duplicateHandle

getSystemInfo

MapViewOfFileEx

fonctions de gestion de la mémoire

OpenFileMapping

SYSTEM_INFO

UnmapViewOfFile