共用方式為

NtCreateFile 函式 (ntifs.h)

  • 發行項

NtCreateFile 例程會建立新的檔案或開啟現有的檔案。

語法

__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateFile(
  [out]          PHANDLE            FileHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in]           POBJECT_ATTRIBUTES ObjectAttributes,
  [out]          PIO_STATUS_BLOCK   IoStatusBlock,
  [in, optional] PLARGE_INTEGER     AllocationSize,
  [in]           ULONG              FileAttributes,
  [in]           ULONG              ShareAccess,
  [in]           ULONG              CreateDisposition,
  [in]           ULONG              CreateOptions,
  [in, optional] PVOID              EaBuffer,
  [in]           ULONG              EaLength
);

參數

[out] FileHandle

HANDLE 變數的指標，可接收檔案句柄。

[in] DesiredAccess

指定 ACCESS_MASK 值，決定對物件的要求存取。

除了針對所有類型的物件所定義的 標準 訪問許可權之外，呼叫端還可以指定下列任何 特定 訪問許可權;也就是說，檔案特有的許可權。

ACCESS_MASK旗標 允許呼叫端執行此動作
FILE_READ_DATA 從檔案讀取數據。
FILE_READ_ATTRIBUTES 讀取檔案的屬性。 如需詳細資訊，請參閱 FileAttributes 參數的描述。
FILE_READ_EA 讀取檔案 (EAS) 擴充屬性。 此旗標與裝置和中繼驅動程序無關。
FILE_WRITE_DATA 將數據寫入檔案。
FILE_WRITE_ATTRIBUTES 寫入檔案的屬性。 如需詳細資訊，請參閱 FileAttributes 參數的描述。
FILE_WRITE_EA 變更檔案 (EAS 的擴充屬性) 。 此旗標與裝置和中繼驅動程序無關。
FILE_APPEND_DATA 將數據附加至檔案。
FILE_EXECUTE 使用系統分頁 I/O 將資料從檔案讀取到記憶體中。 此旗標與裝置和中繼驅動程序無關。

注意

當您建立或開啟目錄時，請勿指定FILE_READ_DATA、FILE_WRITE_DATA、FILE_APPEND_DATA或FILE_EXECUTE。

呼叫端也可以指定下列 泛型 訪問許可權， (套用至所有物件類型的許可權，其中每個泛型訪問許可權的意義都專屬於物件類型) 。 檔案物件的一般訪問許可權對應至特定的訪問許可權，如下表所示。 (請注意，「對應」表示「對應至」，並不表示泛型許可權的值「等於」其特定許可權對應) 的位 OR 值。 I/O 管理員會定義實際的對應。

一般訪問許可權 對應至這些特定的訪問許可權
GENERIC_READ STANDARD_RIGHTS_READ、FILE_READ_DATA、FILE_READ_ATTRIBUTES、FILE_READ_EA和 SYNCHRONIZE
GENERIC_WRITE STANDARD_RIGHTS_WRITE、FILE_WRITE_DATA、FILE_WRITE_ATTRIBUTES、FILE_WRITE_EA、FILE_APPEND_DATA和 SYNCHRONIZE
GENERIC_EXECUTE STANDARD_RIGHTS_EXECUTE、FILE_EXECUTE、FILE_READ_ATTRIBUTES和 SYNCHRONIZE。 此值與裝置和中繼驅動程序無關。
GENERIC_ALL FILE_ALL_ACCESS

注意

一般 訪問許可權只能指定給檔案;無法為目錄指定它們。

某些 CreateOptions 旗標需要在呼叫 NtCreateFile 時，在 DesiredAccess 中設定特定存取旗標。 如需這些詳細數據，請參閱 CreateOptions 參數。

例如，如果您為檔案物件指定GENERIC_READ，例程會將此值對應至特定訪問許可權的FILE_GENERIC_READ位掩碼。 在上表中，針對GENERIC_READ列出的特定訪問許可權會對應至 (，但不等於) 包含在FILE_GENERIC_READ位掩碼中的存取旗標。

如果檔案實際上是目錄，呼叫端也可以指定下列泛型訪問許可權。

DesiredAccess 旗標 允許呼叫端執行此動作
FILE_LIST_DIRECTORY 列出目錄中的檔案。
FILE_TRAVERSE 周遊目錄，換句話說，在檔案的路徑中包含 目錄。

如需訪問許可權的詳細資訊，請參閱 ACCESS_MASK 和 訪問許可權。

[in] ObjectAttributes

指定物件名稱和其他屬性 之OBJECT_ATTRIBUTES 結構的指標。 使用 InitializeObjectAttributes 初始化這個結構。 如果呼叫端未在系統線程內容中執行，它必須在呼叫 InitializeObjectAttributes 時設定OBJ_KERNEL_HANDLE屬性。

[out] IoStatusBlock

接收最終完成狀態 的IO_STATUS_BLOCK 結構的指標，以及所要求作業的其他資訊。 特別是 ，Information 成員會收到下列其中一個值：

  • FILE_CREATED
  • FILE_OPENED
  • FILE_OVERWRITTEN
  • FILE_SUPERSEDED
  • FILE_EXISTS
  • FILE_DOES_NOT_EXIST

[in, optional] AllocationSize

包含所建立或覆寫檔案之初始配置大小的LARGE_INTEGER指標，以位元組為單位。 如果 AllocationSize 為 NULL，則不會指定配置大小。 如果未建立或覆寫任何檔案， 則會忽略 AllocationSize 。

[in] FileAttributes

指定一或多個FILE_ATTRIBUTE_XXX 旗標，代表當您建立或覆寫檔案時所要設定的檔案屬性。 呼叫端通常會指定FILE_ATTRIBUTE_NORMAL，這會設定預設屬性。 如需有效FILE_ATTRIBUTE_XXX 旗標的清單，請參閱 Microsoft Windows SDK 檔中的 CreateFile 例程。 如果未建立或覆寫任何檔案， 則會忽略 FileAttributes 。

[in] ShareAccess

共用存取的類型，指定為零或下列旗標的任何組合。

ShareAccess 旗標 允許其他線程執行此動作
FILE_SHARE_READ 讀取檔案
FILE_SHARE_WRITE 寫入檔案
FILE_SHARE_DELETE 刪除檔案

裝置和中繼驅動程式通常會將 ShareAccess 設定為零，這可讓呼叫端獨佔存取開啟的檔案。

[in] CreateDisposition

指定檔案不存在或不存在時要執行的動作。 CreateDisposition 可以是下表中的其中一個值。

CreateDisposition 值 如果檔案存在，則為動作 如果檔案不存在，則為動作
FILE_SUPERSEDE 取代檔案。 建立檔案。
FILE_CREATE 傳回錯誤。 建立檔案。
FILE_OPEN 開啟該檔案。 傳回錯誤。
FILE_OPEN_IF 開啟該檔案。 建立檔案。
FILE_OVERWRITE 開啟檔案，並加以覆寫。 傳回錯誤。
FILE_OVERWRITE_IF 開啟檔案，並加以覆寫。 建立檔案。

[in] CreateOptions

指定驅動程式建立或開啟檔案時要套用的選項。 使用下表中的一或多個旗標。

CreateOptions 旗標 意義
FILE_DIRECTORY_FILE (0x00000001) 檔案是目錄。 相容的 CreateOptions 旗標是FILE_SYNCHRONOUS_IO_ALERT、FILE_SYNCHRONOUS_IO_NONALERT、FILE_WRITE_THROUGH、FILE_OPEN_FOR_BACKUP_INTENT和FILE_OPEN_BY_FILE_ID。 CreateDisposition 參數必須設定為FILE_CREATE、FILE_OPEN或FILE_OPEN_IF。
FILE_WRITE_THROUGH (0x00000002) 將數據寫入檔案的系統服務、檔案系統驅動程式和驅動程式必須實際將數據傳輸到檔案，才能將任何要求的寫入作業視為完成。
FILE_SEQUENTIAL_ONLY (0x00000004) 對檔案的所有存取都是循序的。
FILE_NO_INTERMEDIATE_BUFFERING (0x00000008) 檔案無法在驅動程式的內部緩衝區中快取或緩衝處理。 此旗標與 DesiredAccess 參數的 FILE_APPEND_DATA 旗標不相容。
FILE_SYNCHRONOUS_IO_ALERT (0x00000010) 檔案上的所有作業都會同步執行。 代表來電者的任何等候，都受限於警示的提前終止。 此旗標也會讓 I/O 系統維護檔案位置指標。 如果設定此旗標，則 SYNCHRONIZE 旗標必須在 DesiredAccess 參數中設定。
FILE_SYNCHRONOUS_IO_NONALERT (0x00000020) 檔案上的所有作業都會同步執行。 在同步處理 I/O 佇列和完成的系統中等候，不會受限於警示。 此旗標也會讓 I/O 系統維護檔案位置內容。 如果設定此旗標，則 SYNCHRONIZE 旗標必須在 DesiredAccess 參數中設定。
FILE_NON_DIRECTORY_FILE (0x00000040) 檔案 不是 目錄。 要開啟的檔案物件可以代表數據檔;邏輯、虛擬或實體裝置;或磁碟區。 從 Windows 11 24H2 版開始，NTFS 現在會在開啟 $INDEX_ALLOCATION 屬性時接受此旗標。
FILE_CREATE_TREE_CONNECTION (0x00000080) Create 此檔案的樹狀結構連線，以便透過網路開啟。 裝置和中繼驅動程式不會使用此旗標。
FILE_COMPLETE_IF_OPLOCKED (0x00000100) 如果目標檔案為 oplock，而不是封鎖呼叫端的線程，請立即以替代成功碼STATUS_OPLOCK_BREAK_IN_PROGRESS完成此作業。 如果檔案為 oplocked，則另一個呼叫端已經可以存取該檔案。 裝置和中繼驅動程式不會使用此旗標。
FILE_NO_EA_KNOWLEDGE (0x00000200) 如果已開啟之現有檔案的擴充屬性 (EAS) 表示呼叫端必須瞭解 EA 才能正確解譯檔案， 則 NtCreateFile 應該會傳回錯誤。 此旗標與裝置和中繼驅動程序無關。
FILE_OPEN_REMOTE_INSTANCE (0x00000400) 保留供系統使用;請勿使用 。
FILE_RANDOM_ACCESS (0x00000800) 檔案的存取權可以是隨機的，因此檔系統驅動程式或系統應該不會執行循序的預先讀取作業。
FILE_DELETE_ON_CLOSE (0x00001000) 當檔案的最後一個句柄傳遞至 NtClose 時，系統會刪除檔案。 如果設定此旗標，必須在 DesiredAccess 參數中設定 DELETE 旗標。
FILE_OPEN_BY_FILE_ID (0x00002000) ObjectAttributes 參數指定的檔名包含檔案的二進位 8 位元組或 16 位元組檔案參考編號或物件標識碼，視文件系統而定。 或者，裝置名稱後面接著反斜杠字元可能會繼續這些二進位值。 如需其他詳細數據和範例，請參閱。
FILE_OPEN_FOR_BACKUP_INTENT (0x00004000) 正在開啟檔案以供備份意圖使用。 因此，系統應該檢查特定訪問許可權，並將適當的存取權授與呼叫者，再針對檔案的安全性描述元檢查 DesiredAccess 參數。 裝置和中繼驅動程式不會使用此旗標。
FILE_NO_COMPRESSION (0x00008000) 隱藏父目錄中FILE_ATTRIBUTE_COMPRESSED的繼承。 這可讓您在標示為壓縮的目錄中建立非壓縮檔案。
FILE_OPEN_REQUIRING_OPLOCK (0x00010000) 檔案正在開啟，而檔案上 (oplock) 的商機鎖定會要求為單一不可部分完成的作業。 文件系統在執行建立作業之前會先檢查 oplock，如果結果會中斷現有的 oplock，則會讓建立失敗並傳回STATUS_CANNOT_BREAK_OPLOCK代碼。 從 Windows 7 和 Windows Server 2008 R2 開始，即可使用此旗標。
FILE_DISALLOW_EXCLUSIVE (0x00020000) 開啟現有的檔案時，如果未指定FILE_SHARE_READ，而且文件系統存取檢查不會授與呼叫端對檔案的寫入許可權，則此開啟會失敗，並STATUS_ACCESS_DENIED。 這是 Windows 7 之前的預設行為。 從 Windows 7 和 Windows Server 2008 R2 開始，即可使用此旗標。
FILE_SESSION_AWARE (0x00040000) 開啟檔案或裝置的用戶端會感知會話，並視需要驗證每個會話存取權。 從 Windows 8 開始，即可使用此旗標。
FILE_RESERVE_OPFILTER (0x00100000) 此旗標可讓應用程式要求篩選條件不透明度鎖定 (oplock) ，以防止其他應用程式收到共用違規。 如果已經有開啟的句柄，則建立要求將會失敗，並STATUS_OPLOCK_NOT_GRANTED。 如需詳細資訊，請參閱接下來的＜備註＞一節。
FILE_OPEN_REPARSE_POINT (0x00200000) 使用重新分析點開啟檔案，並略過檔案的一般重新分析點處理。 如需詳細資訊，請參閱接下來的＜備註＞一節。
FILE_OPEN_NO_RECALL (0x00400000) 指示執行離線記憶體或虛擬化的任何篩選條件，不要重新叫用此開啟後檔案的內容。
FILE_OPEN_FOR_FREE_SPACE_QUERY (0x00800000) 此旗標會指示文件系統擷取與呼叫線程相關聯的使用者。 使用傳回的句柄對 FltQueryVolumeInformation 或 ZwQueryVolumeInformationFile 的任何後續呼叫都會假設擷取的使用者，而不是在當時呼叫的使用者，以計算呼叫端可用的可用空間。 這適用於下列 FsInformationClass 值：FileFsSizeInformation、FileFsFullSizeInformation 和 FileFsFullSizeInformationEx。
FILE_CONTAINS_EXTENDED_CREATE_INFORMATION (0x10000000) 將 EaBuffer 參數解譯為 EXTENDED_CREATE_INFORMATION的實例。 從 Windows 11 22H2 版開始，即可使用此旗標。

[in, optional] EaBuffer

對於裝置和中繼驅動程式，此參數必須是 NULL 指標。

[in] EaLength

對於裝置和中繼驅動程式，此參數必須為零。

傳回值

NtCreateFile 會在成功時傳回STATUS_SUCCESS，或在失敗時傳回適當的 NTSTATUS 錯誤碼。 在後者的情況下，呼叫端可以藉由檢查 IoStatusBlock 參數來判斷失敗的原因。

注意

NtCreateFile 可能會傳回STATUS_FILE_LOCK_CONFLICT做為傳回值，或在IoStatusBlock參數所指向之IO_STATUS_BLOCK結構的 Status 成員中傳回。 只有在NTFS記錄檔已滿，而且 NtCreateFile 嘗試處理這種情況時，才會發生此錯誤。

備註

NtCreateFile 提供呼叫端可用來操作檔案數據的句柄，或檔案物件的狀態和屬性。 如需詳細資訊，請參閱 在驅動程式中使用檔案。

當 FileHandle 所指向的句柄不再使用之後，驅動程式必須呼叫 NtClose 以關閉它。

如果呼叫端未在系統線程內容中執行，則必須確保所建立的任何句柄都是私用句柄。 否則，進程可以在其中執行驅動程序的內容中存取句柄。 如需詳細資訊，請參閱 物件句柄。

有兩種替代方式可指定要使用 NtCreateFile 建立或開啟的檔名：

  • 做為完整路徑名稱，提供於輸入 ObjectAttributes 的 ObjectName 成員中。
  • 作為路徑名稱，相對於輸入 ObjectAttributes 之 RootDirectory 成員中句柄所代表的目錄檔案。

DesiredAccess 參數中設定特定旗標會導致下列效果：

  • 若要讓呼叫端等候傳回的 FileHandle 來同步處理 I/O 完成，必須設定 SYNCHRONIZE 旗標。 否則，屬於裝置或中繼驅動程式的呼叫端必須使用事件物件來同步處理 I/O 完成。
  • 如果呼叫端只設定FILE_APPEND_DATA和 SYNCHRONIZE 旗標，它只能寫入檔案結尾，而且會忽略對檔案寫入作業的任何位移資訊。 此類型的作業將視需要自動擴充檔案。
  • 設定檔案的FILE_WRITE_DATA旗標，也可讓呼叫端在檔案結尾以外寫入。 同樣地，檔案會視需要自動擴充。
  • 如果呼叫端只設定FILE_EXECUTE和 SYNCHRONIZE 旗標，則無法使用傳回的 FileHandle 直接讀取或寫入檔案中的任何數據。 也就是說，檔案上的所有作業都會透過系統呼叫器進行，以回應指令和數據存取作業。 裝置和中繼驅動程序不應該設定FILE_EXECUTE旗標。

ShareAccess 參數會判斷個別線程是否可以同時存取相同的檔案。 前提是這兩個呼叫端都有適當的存取權，即可成功開啟和共用檔案。 如果 NtCreateFile 的原始呼叫端未指定FILE_SHARE_READ、FILE_SHARE_WRITE或FILE_SHARE_DELETE，則沒有其他呼叫端可以開啟檔案，也就是說，原始呼叫端會被授與獨佔存取權。

若要成功開啟共用檔案， DesiredAccess 旗標必須與所有先前尚未透過 發行之開啟作業的 DesiredAccess 和 ShareAccess 旗標相容。 也就是說，指定給指定檔案之 NtCreateFile 的 DesiredAccess 不得與其他檔案開啟者不允許的存取發生衝突。

CreateDisposition 值FILE_SUPERSEDE要求呼叫端具有現有檔案物件的 DELETE 存取權。 如果是，在現有檔案上成功呼叫具有FILE_SUPERSEDE的 NtCreateFile 會有效地刪除該檔案，然後重新建立它。 這表示，如果檔案已經由另一個線程開啟，它會指定 ShareAccess 參數並設定FILE_SHARE_DELETE旗標來開啟檔案。 請注意，這種類型的處置與覆寫檔案的POSIX樣式一致。

CreateDisposition 值FILE_OVERWRITE_IF和FILE_SUPERSEDE類似。 如果使用現有的檔案和其中一個 CreateDisposition 值呼叫 NtCreateFile，將會取代檔案。

覆寫檔案的語意相當於取代作業，但下列專案除外：

  • 呼叫端必須具有檔案的寫入許可權，而不是刪除存取權。 這表示，如果檔案已由另一個線程開啟，則會開啟檔案，並在輸入 ShareAccess 中設定FILE_SHARE_WRITE旗標。
  • 指定的檔案屬性在邏輯上為 ORed，且檔案上已有這些屬性。 這表示，如果檔案已由另一個線程開啟， 則 NtCreateFile 的後續呼叫端無法停用現有的 FileAttributes 旗標，但可以啟用相同檔案的其他旗標。 請注意，此覆寫檔案的樣式與 MS-DOS、Microsoft Windows 3.1 和 OS/2 一致。

FILE_DIRECTORY_FILE CreateOptions 值會指定要建立或開啟的檔案是目錄。 建立目錄檔案時，文件系統會在磁碟上建立適當的結構，以代表該特定文件系統的磁碟上結構的空白目錄。 如果指定此選項且要開啟的指定檔案不是目錄檔案，或者呼叫端指定不一致的 CreateOptions 或 CreateDisposition 值， 則 NtCreateFile 的呼叫將會失敗。

FILE_NO_INTERMEDIATE_BUFFERING CreateOptions 旗標可防止文件系統代表呼叫端執行任何中繼緩衝。 指定此旗標會將呼叫端參數的下列限制放在其他 ZwXxx檔案 例程上。

  • 任何傳遞至 NtReadFile 或 NtWriteFile 的選擇性 ByteOffset 都必須是扇區大小的倍數。
  • 傳遞至 NtReadFile 或 NtWriteFile 的 Length 必須是扇區大小的整數。 請注意，指定讀取作業給長度完全是扇區大小的緩衝區，可能會導致在傳輸期間到達檔案結尾時，傳送到該緩衝區的顯著位元組數目較少。
  • 緩衝區必須根據基礎裝置的對齊需求進行對齊。 若要取得這項資訊，請呼叫 NtCreateFile 以取得代表實體裝置之檔案物件的句柄，並將該句柄傳遞至 NtQueryInformationFile。 如需系統FILE_XXX_ALIGNMENT值的清單，請參閱 DEVICE_OBJECT。
  • 呼叫 NtSetInformationFile 並將 FileInformationClass 參數設定為 FilePositionInformation 時，必須指定扇區大小的倍數位移。

FILE_SYNCHRONOUS_IO_ALERT和 FILE_SYNCHRONOUS_IO_NONALERT CreateOptions 旗標 (互斥) 指定檔案上的所有 I/O 作業都會同步，只要作業是透過傳回的 FileHandle 所參考的檔案對象進行， 即可。 這類檔案上的所有 I/O 都會使用傳回的句柄，跨所有線程串行化。 如果已設定上述任一 CreateOptions 旗標，則 SYNCHRONIZE DesiredAccess 旗標也必須設定為強制 I/O 管理員使用檔案物件做為同步處理物件。 在這些情況下，I/O 管理員會追蹤目前的檔案位置位移，您可以傳遞至 NtReadFile 和 NtWriteFile。 呼叫 NtQueryInformationFile 或 NtSetInformationFile 以取得或設定此位置。

如果未指定CreateOptions FILE_OPEN_REPARSE_POINT 旗標，而 NtCreateFile 會嘗試開啟具有重新分析點的檔案，則檔案會進行一般重新分析點處理。 另一方面，如果指定了FILE_OPEN_REPARSE_POINT旗標，則 不會 進行一般重新分析處理， 而且 NtCreateFile 會嘗試直接開啟重新分析點檔案。 在任一情況下，如果開啟作業成功， NtCreateFile 會傳回STATUS_SUCCESS;否則，例程會傳回NTSTATUS錯誤碼。 NtCreateFile 永遠不會傳回STATUS_REPARSE。

CreateOptions FILE_OPEN_REQUIRING_OPLOCK 旗標可排除開啟檔案並要求可能允許第三方開啟檔案並取得共用違規的 oplock 之間的時間。 應用程式可以使用 NtCreateFile 上的 FILE_OPEN_REQUIRING_OPLOCK 旗標，然後要求任何 oplock。 這可確保 oplock 擁有者會收到任何後續開啟要求而導致共用違規的通知。

在 Windows 7 中，如果應用程式使用 FILE_OPEN_REQUIRING_OPLOCK 旗標時，檔案上有其他句柄，則建立作業將會失敗，且STATUS_OPLOCK_NOT_GRANTED。 從 Windows 8 開始，此限制已不存在。

如果此建立作業會中斷檔案上已經存在的 oplock，則設定 FILE_OPEN_REQUIRING_OPLOCK 旗標會導致建立作業失敗，並出現STATUS_CANNOT_BREAK_OPLOCK。 此建立作業不會中斷現有的 oplock。

使用FILE_OPEN_REQUIRING_OPLOCK旗標的應用程式必須在呼叫成功之後要求 oplock，否則所有後續嘗試開啟檔案都會遭到封鎖，而不需要一般 oplock 處理的優點。 同樣地，如果此呼叫成功，但後續的 oplock 要求失敗，則使用此旗標的應用程式必須在偵測到 oplock 要求失敗之後關閉其句柄。

注意

windows 7、Windows Server 2008 R2 和更新版本的 Windows 操作系統提供FILE_OPEN_REQUIRING_OPLOCK旗標。 在 Windows 7 中實作此旗標的 Microsoft 文件系統為 NTFS、FAT 和 exFAT。

CreateOptions 旗標FILE_RESERVE_OPFILTER可讓應用程式要求層級 1、Batch 或 Filter oplock，以防止其他應用程式收到共享違規。 不過，FILE_RESERVE_OPFILTER僅適用於篩選作業鎖定。 若要使用它，您必須完成下列步驟：

  1. 使用FILE_RESERVE_OPFILTER的 CreateOptions 、完全FILE_READ_ATTRIBUTES的 DesiredAccess 和完全FILE_SHARE_READ的 ShareAccess 發出建立要求 |FILE_SHARE_WRITE |FILE_SHARE_DELETE。
    • 如果已經有開啟的句柄，則建立要求會失敗並STATUS_OPLOCK_NOT_GRANTED，而下一個要求的 oplock 也會失敗。
    • 如果您以更多存取權或較少的共享開啟，也會造成STATUS_OPLOCK_NOT_GRANTED失敗。
  2. 如果建立要求成功，請要求 oplock。
  3. 開啟檔案的另一個句柄以執行 I/O。

步驟 3 僅針對篩選作業鎖定進行這項操作。 在步驟 3 中開啟的句柄可以有一個 DesiredAccess ，其中包含最多FILE_READ_ATTRIBUTES |FILE_WRITE_ATTRIBUTES |FILE_READ_DATA |FILE_READ_EA |FILE_EXECUTE |SYNCHRONIZE |READ_CONTROL，但仍不會中斷篩選作業鎖定。 不過，任何 DesiredAccess 大於 FILE_READ_ATTRIBUTES |FILE_WRITE_ATTRIBUTES |SYNCHRONIZE 會中斷層級 1 或 Batch oplock，並讓FILE_RESERVE_OPFILTER旗標不適用於這些 oplock 類型。

NTFS 是唯一實作FILE_RESERVE_OPFILTER的 Microsoft 文件系統。

針對 CreateOptions FILE_OPEN_BY_FILE_ID 旗標，範例裝置名稱的格式如下：

\??\C:\<FileID>
\device\HardDiskVolume1\<ObjectID>

其中 FileID 是 8 個字節， 而 ObjectID 是 16 個字節：

  • 在NTFS上，這可以是8位元組或16位元組的參考編號或對象標識碼。 16 位元組參考編號與以零填補的8位元組數位相同。
  • 在 ReFS 上，這可以是 8 位元組或 16 位元組的參考編號。 16 位元組的數位與8位元組的數字無關。 不支援物件識別碼。
  • FAT、ExFAT、UDFS 和 CDFS 檔案系統不支援FILE_OPEN_BY_FILE_ID旗標。

這個數位是由 特定文件系統所指派，而且是特定的。 因為檔名字段部分會包含二進位 Blob，所以假設這是有效的 Unicode 字串，更重要的是可能不是 Null 終止的字串。

NtCreateFile 的呼叫端必須在 IRQL = PASSIVE_LEVEL且啟用特殊核心 APC 時執行。

注意

如果呼叫此函式發生在使用者模式中，您應該使用名稱 「NtCreateFile」 而不是 「ZwCreateFile」。

對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。

規格需求

需求 值
最低支援的用戶端 Windows 2000
目標平台 Universal
標頭 ntifs.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL (请参阅一节)
DDI 合規性規則 HwStorPortProhibitedDIS、 PowerIrpDDis

另請參閱

ACCESS_MASK

DEVICE_OBJECT

EXTENDED_CREATE_INFORMATION

IO_STATUS_BLOCK

InitializeObjectAttributes

NtClose

NtOpenFile

NtQueryInformationFile

NtReadFile

NtSetInformationFile

NtWriteFile