Funzione EngMapFile (winddi.h)

La funzione EngMapFile crea o apre un file e la esegue il mapping nello spazio di sistema.

Sintassi

ENGAPI PVOID EngMapFile(
  [in]  LPWSTR    pwsz,
  [in]  ULONG     cjSize,
  [out] ULONG_PTR *piFile
);

Parametri

[in] pwsz

Puntatore a una stringa con terminazione null contenente il nome completo del file da eseguire il mapping. Un esempio di stringa di nome file completo è L"\?? \c:\test.dat".

[in] cjSize

Specifica il numero di byte del file da mappare.

[out] piFile

Puntatore a un percorso di memoria che riceve un identificatore per il file mappato, purché il mapping abbia avuto esito positivo. Se il mapping non è riuscito, la posizione di memoria riceve il valore zero. Quando il file mappato deve essere rilasciato, questo valore deve essere passato a EngUnmapFile.

Valore restituito

EngMapFile restituisce un puntatore alla visualizzazione mappata del file se ha esito positivo. In caso contrario, restituisce NULL.

Commenti

Se il file esiste già, EngMapFile viene aperto e mappato per la lettura/scrittura. Se il file non esiste, EngMapFile crea e lo esegue il mapping per la lettura/scrittura.

Il valore di cjSize influisce sul mapping del file come indicato di seguito:

• Quando cjSize è zero, GDI esegue il mapping del file nell'intera dimensione.
• Quando cjSize è maggiore delle dimensioni del file, GDI espande il file in byte cjSize prima di eseguire il mapping nella memoria di sistema. Nessun presupposto deve essere fatto sul contenuto della memoria che si estende oltre le dimensioni originali del file.
• Quando cjSize è minore delle dimensioni del file, GDI tronca il file in byte cjSize prima di eseguire il mapping nella memoria di sistema.

Requisiti

Vedi anche

EngDeleteFile

EngUnmapFile