FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL （winioctl.h）

啟用目標磁碟區上更新序號 （USN） 變更日誌數據流的範圍追蹤功能，或修改已啟用的範圍追蹤參數。

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to volume
  FSCTL_USN_TRACK_MODIFIED_RANGES,  // dwIoControlCode
  (LPDWORD) lpInBuffer,             // input buffer
  (DWORD) nInBufferSize,            // size of input buffer
  (LPDWORD) lpOutBuffer,            // lpOutbuffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

言論

如需此作業上重疊 I/O 的影響，請參閱 DeviceIoControl 主題的一節。

您可以使用 FSCTL_USN_TRACK_MODIFIED_RANGES，第一次針對磁碟區啟用範圍追蹤。 啟用範圍追蹤之後，該磁碟區的狀態和參數將會保存，並在下次重新啟動時，從保存的參數初始化範圍追蹤。

您也可以使用 FSCTL_USN_TRACK_MODIFIED_RANGES 來修改現有的變更日誌數據流範圍追蹤參數。 如果範圍追蹤已經存在，FSCTL_USN_TRACK_MODIFIED_RANGES 將它設定為 USN_TRACK_MODIFIED_RANGES 結構中提供的參數。 區塊大小或檔案大小閾值只能從先前的值降低。 啟用之後，除非刪除日誌，否則無法停用範圍追蹤功能。

若要擷取磁碟區的句柄，請使用 下列格式的 lpFileName 參數呼叫 createFile：

\\.\X：

在上述字串中，X 是識別磁碟區出現所在的磁碟驅動器的字母。 磁碟區必須是NTFS 3.0或更新版本。 若要取得磁碟區的NTFS版本，請使用系統管理員訪問許可權開啟命令提示字元，然後執行下列命令：

fsutil fsinfo ntfsinfoX：

其中 X 是磁碟區的驅動器號。

要求

要求	價值
最低支援的用戶端	Windows 8.1 [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2012 R2 [僅限傳統型應用程式]
標頭	winioctl.h （包括 Windows.h）

另請參閱

• DeviceIoControl