Fungsi NdisMapFile (ndis.h)

Artikel
02/26/2024

Fungsi NdisMapFile memetakan file yang sudah terbuka ke buffer yang dapat diakses pemanggil jika file saat ini tidak dipetakan.

Sintaks

void NdisMapFile(
  [out] PNDIS_STATUS Status,
  [out] PVOID        *MappedBuffer,
  [in]  NDIS_HANDLE  FileHandle
);

Parameter

[out] Status

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan status operasi pemetaan, yang bisa menjadi salah satu hal berikut:

NDIS_STATUS_SUCCESS

Pemanggil memiliki akses eksklusif ke konten file sampai fungsi NdisUnmapFile dipanggil.

NDIS_STATUS_ALREADY_MAPPED

Penelepon tidak dapat mengakses isi file saat ini.

[out] MappedBuffer

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan alamat virtual dasar konten file yang dipetakan atau NULL.

[in] FileHandle

Handel yang dikembalikan oleh panggilan sebelumnya ke fungsi NdisOpenFile .

Nilai kembali

Tidak ada

Keterangan

NdisMapFile mengaitkan (peta) rentang alamat virtual dengan file yang dibuka sehingga driver dapat mengakses konten file. NdisMapFile hanya memungkinkan satu pemetaan file tertentu untuk menjadi luar biasa kapan saja. Akibatnya, penelepon yang berhasil diberikan akses eksklusif ke data file sampai NdisUnmapFile atau fungsi NdisCloseFile dipanggil.

Driver miniport dapat memetakan dan membatalkan pemetaan file terbuka seperlunya, menggunakan panggilan alternatif ke NdisMapFile dan NdisUnmapFile. Panggilan ke NdisCloseFile merilis FileHandle dan membatalkan alokasi buffer yang berisi konten file.

Driver miniport hanya dapat memanggil NdisMapFile selama inisialisasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 (lihat NdisMapFile (NDIS 5.1)) di Windows Vista. Didukung untuk driver NDIS 5.1 (lihat NdisMapFile (NDIS 5.1)) di Windows XP.
Target Platform	Universal
Header	ndis.h (sertakan Video.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis)