IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)
Permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES ini digunakan untuk mengirim permintaan manajemen himpunan data ke perangkat penyimpanan.
Kode utama
Buffer input
Buffer di Irp-AssociatedIrp.SystemBuffer> berisi struktur DEVICE_DSM_INPUT. Bergantung pada anggota Tindakan dari struktur ini, buffer input mungkin juga menyertakan blok parameter dan blok rentang himpunan data. Lihat Deskripsi DEVICE_DSM_ACTION untuk deskripsi semua tindakan yang mungkin.
Panjang buffer input
Parameters.DeviceIoControl.InputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer, yang harus setidaknya sizeof(DEVICE_DSM_INPUT).
Buffer output
Bergantung pada nilai yang ditetapkan dalam anggota Tindakan DEVICE_DSM_INPUT, permintaan dapat mengembalikan data dalam buffer di Irp-AssociatedIrp.SystemBuffer>. Buffer sistem akan berisi data DEVICE_DSM_OUTPUT yang valid jika operasi DSM mengembalikan output dan Parameters.DeviceIoControl.OutputBufferLength> 0. Bergantung pada Tindakan, buffer output mungkin juga menyertakan blok output.
Panjang buffer output
Panjang dalam byte buffer output, jika ada. Jika output dikembalikan, buffer output harus setidaknya ukuranof(DEVICE_DSM_OUTPUT).
Blok status
Bidang Status dapat diatur ke STATUS_SUCCESS, atau mungkin ke STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_TOO_SMALL, STATUS_BUFFER_OVERFLOW, atau beberapa status kesalahan lainnya.
Keterangan
Karena persyaratan kumpulan memori oleh tumpukan driver penyimpanan, penyelesaian IRP yang berisi IOCTL ini harus berada di IRQL < DISPATCH_LEVEL.
Lihat Gambaran Umum Manajemen Himpunan Data untuk informasi selengkapnya.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | ntddstor.h (termasuk Ntddstor.h) |
IRQL | DISPATCH_LEVEL IRQL < (Lihat bagian Keterangan.) |