Share via

Fungsi SetFileIoOverlappedRange (fileapi.h)

  • Artikel

Mengaitkan rentang alamat virtual dengan handel file yang ditentukan. Ini menunjukkan bahwa kernel harus mengoptimalkan permintaan I/O asinkron lebih lanjut dengan struktur yang tumpang tindih di dalam rentang ini. Rentang tumpang tindih dikunci dalam memori, lalu dibuka kuncinya saat file ditutup. Setelah rentang dikaitkan dengan handel file, rentang tidak dapat dikaitkan.

Sintaks

BOOL SetFileIoOverlappedRange(
  [in] HANDLE FileHandle,
  [in] PUCHAR OverlappedRangeStart,
  [in] ULONG  Length
);

Parameter

[in] FileHandle

Handel ke file.

Handel file ini harus dibuka dengan hak akses FILE_READ_ATTRIBUTES .

[in] OverlappedRangeStart

Alamat awal untuk rentang.

[in] Length

Panjang rentang, dalam byte.

Mengembalikan nilai

Mengembalikan bukan nol jika berhasil atau nol sebaliknya.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

SetFileIoOverlappedRange dapat digunakan untuk meningkatkan performa dalam aplikasi yang mengeluarkan sejumlah besar I/O tidak buffer asinkron dan menggunakan rentang struktur yang tumpang tindih yang ditentukan. Karena rentang struktur ini dikunci dalam memori, kernel dapat menghindari memperoleh kunci tertentu saat memperbarui struktur yang tumpang tindih dengan hasil permintaan I/O.

SetFileIoOverlappedRange mengharuskan pemanggil memiliki hak istimewa akses SeLockMemoryPrivilege .

Fungsi ini tidak berpengaruh pada I/O yang di-buffer dan sinkron.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Ya
SMB 3.0 Transparent Failover (TFO) Ya
SMB 3.0 dengan Scale-out File Shares (SO) Ya
Sistem File Volume Bersama Kluster (CsvFS) Ya
Sistem File Tangguh (ReFS) Ya

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header fileapi.h (termasuk Windows.h, WinBase.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

Fungsi Manajemen File