IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

  • 發行項

從磁碟片清除所有磁碟區陰影複製服務 (VSS) 硬體型快照集資訊。 快照集也稱為陰影複製。 此要求適用於 Windows Vista 和更新版本的 Windows 作業系統。 呼叫端必須在 IRQL = PASSIVE_LEVEL執行。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

無。

輸入緩衝區長度

無。

輸出緩衝區

無。

輸出緩衝區長度

無。

狀態區塊

Information 成員設定為零。 如果作業成功， 狀態 成員會設定為STATUS_SUCCESS。 否則， Status 成員會設定為適當的錯誤碼。

備註

您可以從內核模式驅動程式或使用者模式應用程式發出這個 I/O 控制件程式代碼。 從內核模式驅動程式發出此 I/O 控制程式代碼時，呼叫端會提供 I/O 要求封包 (IRP) ，其中包含IO_STATUS_BLOCK數據結構。 此數據結構用來將錯誤資訊傳回給呼叫端。 從 具有 DeviceIocontrol 例程的使用者模式應用程式發出此 I/O 控件程式代碼時，呼叫端可以藉由呼叫 GetLastError 例程來取得錯誤資訊。

發出此 IOCTL 時使用其句柄的磁碟，可能會在發出 IOCTL 時處於離線狀態。 如果使用磁碟管理員 Microsoft Management Console (MMC) 嵌入式管理單元進入離線狀態，磁碟將會設定其只讀屬性，這會導致此 IOCTL 失敗。 不過，如果磁碟分區公用程式 (Diskpart.exe) 用來讓磁碟處於離線狀態，則不會設定磁碟的唯讀屬性。 因此，最好使用磁碟分區公用程式將磁碟置於離線狀態。

注意 使用此 IOCTL 的副作用是磁碟管理工具可能會報告 GPT 磁碟上類型 “UNKNOWN” 的其他磁碟分區。 這個 256 KB 的數據分割是由 IOCTL 作業所建立，而且是還原程式中所使用的快照集分割區。 此分割區必須是，而且可由系統管理員忽略。
 

規格需求

需求 值
最低支援的用戶端 從 Windows Vista 開始提供。
標頭 ntdddisk.h (包含 Ntdddisk.h)
IRQL PASSIVE_LEVEL