Fonction MapViewOfFileNuma2 (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 MapViewOfFileNuma2(
  [in]           HANDLE  FileMappingHandle,
  [in]           HANDLE  ProcessHandle,
  [in]           ULONG64 Offset,
  [in, optional] PVOID   BaseAddress,
  [in]           SIZE_T  ViewSize,
  [in]           ULONG   AllocationType,
  [in]           ULONG   PageProtection,
  [in]           ULONG   PreferredNode
);

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.

[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 page volumineuse

[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.

[in] PreferredNode

Nœud NUMA préféré pour cette mémoire.

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.

Configuration requise

Condition requise Valeur
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 ; Onecoreuap.lib
DLL Api-ms-win-core-memory-l1-1-5.dll

Voir aussi

MapViewOfFile

MapViewOfFileNuma