IoRegisterFileSystem 函式 (ntifs.h)

IoRegisterFileSystem 例程會將文件系統的控制裝置物件新增至全域文件系統佇列。

語法

void IoRegisterFileSystem(
  [in] __drv_aliasesMem PDEVICE_OBJECT DeviceObject
);

[in] DeviceObject

檔系統的控制裝置物件的指標。

無

IoRegisterFileSystem 會將文件系統註冊為使用中文件系統，方法是將文件系統的控制裝置物件插入全域文件系統佇列中，並遞增檔系統控制裝置對象的參考計數。

檔案系統控制裝置物件的裝置類型必須是下列其中一項：

FILE_DEVICE_NETWORK_FILE_SYSTEM

FILE_DEVICE_CD_ROM_FILE_SYSTEM

FILE_DEVICE_DISK_FILE_SYSTEM

如果裝置類型不是下列其中一個值，則不會註冊文件系統。

此外，檔案系統控制裝置對象必須命名。如果未命名，這不會造成呼叫 IoRegisterFileSystem 失敗。不過，檔案系統篩選驅動程式以及許多系統元件和支援例程，請使用這個名稱來區分檔系統的控制裝置對象，這些物件一律會命名，以及永遠不會命名的磁碟區裝置物件。

如果文件系統的控制裝置對象上設定了DO_LOW_PRIORITY_FILESYSTEM旗標，則會將裝置物件插入佇列的下一個位置。 (RAW 檔案系統會佔用 queue.) 如果未設定此旗標，則會在佇列的前端插入裝置物件。

IoRegisterFileSystem 會呼叫已註冊此通知的文件系統篩選驅動程式通知例程，方法是呼叫 IoRegisterFsRegistrationChange 或 IoRegisterFsRegistrationChangeEx。

注意在 Microsoft Windows XP 和更新版本中，當文件系統篩選驅動程式呼叫 IoRegisterFsRegistrationChange 時，也會立即針對任何已經呼叫 IoRegisterFileSystem 的文件系統呼叫其通知例程。