Bagikan melalui


IOCTL_VOLUME_OFFLINE IOCTL (ntddvol.h)

IOCTL IOCTL_VOLUME_OFFLINE menempatkan volume dalam status OFFLINE, yang merupakan status di mana operasi baca dan tulis akan gagal. Permintaan tidak akan diteruskan ke disk fisik sampai IOCTL_VOLUME_ONLINE berikutnya diterima.

Penggunaan umum untuk IOCTL_VOLUME_OFFLINE adalah kasus di mana satu aplikasi atau driver ingin mencegah volume dilepaskan oleh panggilan untuk membuka volume dari aplikasi atau driver kedua saat volume sedang dalam proses dihapus oleh aplikasi atau driver pertama. Misalnya, sebelum menutupi Nomor Unit Logis (LUN), volume pada LUN harus dikunci (opsional), dilepas, diambil offline, dan dihapus instalannya. Sekarang LUN dapat ditutupi tanpa menyebabkan peristiwa penghapusan kejutan Plug and Play (PnP) dicatat untuk volume dan disk itu sendiri. Tanpa panggilan untuk mengambil volume offline, setelah handel yang digunakan untuk melepasnya ditutup, volume kemudian dapat dilepaskan oleh panggilan untuk membukanya dari aplikasi atau driver lain, jika terjadi sebelum panggilan untuk menghapus instalan volume. Panggilan untuk membuka volume berhasil pada volume offline, tetapi I/O yang diarahkan ke volume offline gagal. Mengambil volume offline tidak berpengaruh pada I/O disk (jika aplikasi atau driver membuka handel ke disk), tetapi menghentikan I/O volume (jika aplikasi atau driver membuka handel ke volume).

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Tidak ada.

Panjang buffer input

Tidak ada.

Buffer output

Tidak ada.

Panjang buffer output

Tidak ada.

Blok status

Anggota Status diatur ke STATUS_SUCCESS.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows XP.
Header ntddvol.h (termasuk Ntddvol.h)

Lihat juga

IOCTL_VOLUME_ONLINE