IOCTL_EHSTOR_DEVICE_SET_QUEUE_STATE IOCTL (ehstorioctl.h)
Permintaan IOCTL_EHSTOR_DEVICE_SET_QUEUE_STATE dikirim oleh driver dan aplikasi silo untuk mengubah status antrean perangkat penyimpanan. Permintaan IO dalam antrean perangkat penyimpanan ditahan saat perangkat sementara tidak sah.
Kode utama
Buffer input
Buffer input di Irp-AssociatedIrp.SystemBuffer> berisi struktur ACT_QUEUE_STATE. ACT_QUEUE_STATE dinyatakan dalam ehstorioctl.h sebagai berikut.
typedef struct tagACT_QUEUE_STATE
{
BOOLEAN fFrozen;
} ACT_QUEUE_STATE;
Panjang buffer input
Panjang struktur ACT_QUEUE_STATE .
Buffer output
Tidak ada.
Panjang buffer output
Tidak ada.
Blok status
Salah satu nilai berikut ini dapat dikembalikan di bidang Status .
Nilai Status | Deskripsi |
---|---|
STATUS_SUCCESS | Status antrean berhasil diubah. |
STATUS_INVALID_BUFFER_SIZE | Panjang buffer input terlalu kecil. |
STATUS_ACCESS_DENIED | Permintaan IOCTL tidak dikeluarkan oleh driver silo. |
Keterangan
Driver atau aplikasi Silo dapat membekukan antrean permintaan IO perangkat penyimpanan jika diperlukan unauthorization sementara. Biasanya, unauthorization sementara terjadi selama status daya rendah atau ketika kebijakan memerlukan penguncian perangkat Enhanced Storage seperti sesi pengguna yang terkunci. Dalam kasus seperti itu, lebih baik untuk menangguhkan permintaan IO yang tertunda daripada gagal permintaan IO dan menyebabkan kehilangan data.
Untuk mencegah penyalahgunaan permintaan IOCTL_EHSTOR_DEVICE_SET_QUEUE_STATE oleh aplikasi, hanya driver yang dapat mengeluarkan IOCTL ini. Jika dikirim dari aplikasi mode pengguna, permintaan ini akan gagal dengan STATUS_ACCESS_DENIED.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia dimulai dengan Windows 8 |
Header | ehstorioctl.h (termasuk EhStorIoctl.h) |