Fonction MapViewOfFile2 (memoryapi.h)

  • Article

Mappe une vue d’un fichier ou d’une section sauvegardée dans l’espace d’adressage du processus spécifié.

Syntaxe

PVOID MapViewOfFile2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection
);

Paramètres

[in] FileMappingHandle

HANDLE à une section qui doit être mappée dans l’espace d’adressage du processus spécifié.

[in] ProcessHandle

HANDLE à un processus dans lequel la section sera mappée. Le handle doit avoir le masque d’accès PROCESS_VM_OPERATION .

[in] Offset

Décalage du début de la section. Il doit être aligné sur 64 000.

[in, optional] BaseAddress

Adresse de base souhaitée de la vue. L’adresse est arrondie à la limite de 64 ko la plus proche. Si ce paramètre a la valeur NULL, le système sélectionne l’adresse de base.

[in] ViewSize

Nombre d’octets à mapper. Une valeur de zéro (0) spécifie que la section entière doit être mappée.

[in] AllocationType

Type d’allocation. Ce paramètre peut être égal à zéro (0) ou à l’une des valeurs constantes suivantes :

  • MEM_RESERVE : mappe une vue réservée.
  • MEM_LARGE_PAGES : mappe une vue de grande page. Cet indicateur spécifie que la vue doit être mappée à l’aide de la prise en charge de grandes pages. La taille de la vue doit être un multiple de la taille d’une grande page signalée par la fonction GetLargePageMinimum , et l’objet de mappage de fichiers doit avoir été créé à l’aide de l’option SEC_LARGE_PAGES . Si vous fournissez une valeur non null pour le paramètre BaseAddress , la valeur doit être un multiple de GetLargePageMinimum.

[in] PageProtection

Protection de page souhaitée.

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

Valeur retournée

Retourne l’adresse de base de la vue mappée, si elle réussit. Sinon, retourne null et status d’erreur étendue est disponible à l’aide de GetLastError.

Notes

Cette fonction est implémentée en tant que fonction inline dans l’en-tête et ne se trouve dans aucune bibliothèque d’exportation ou DLL. Il s’agit de l’appel de MapViewOfFileNuma2 avec le dernier paramètre défini sur NUMA_NO_PREFERRED_NODE.

Configuration requise

   
Client minimal pris en charge Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête memoryapi.h (inclure Windows.h, Memoryapi.h)
Bibliothèque onecore.lib
DLL Kernel32.dll

Voir aussi

MapViewOfFile

MapViewOfFileNuma2