IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL (ntddstor.h)
Driver dapat menggunakan IOCTL_STORAGE_DEVICE_POWER_CAP untuk menentukan tingkat konsumsi daya operasional maksimum untuk perangkat penyimpanan. OS akan melakukan yang terbaik untuk transisi perangkat ke status daya yang tidak akan melebihi maksimum yang diberikan; namun, ini tergantung pada apa yang didukung perangkat. Maksimum aktual mungkin kurang dari atau lebih besar dari maksimum yang diinginkan.
Kode utama
Buffer input
Irp->AssociatedIrp.SystemBuffer berisi struktur STORAGE_DEVICE_POWER_CAP yang menentukan daya maksimum.
Panjang buffer input
- Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer parameter input di Irp-AssociatedIrp.SystemBuffer>, yang harus lebih besar dari atau sama dengan
sizeof(STORAGE_DEVICE_POWER_CAP)
.
Buffer output
Jika operasi berhasil, buffer output di Irp-AssociatedIrp.SystemBuffer> akan berisi struktur STORAGE_DEVICE_POWER_CAP.
Panjang buffer output
Parameters.DeviceIoControl.OutputBufferLength menunjukkan ukuran, dalam byte, dari buffer parameter output di Irp-AssociatedIrp.SystemBuffer>. OutputBufferLength harus lebih besar dari atau sama dengan sizeof(STORAGE_DEVICE_POWER_CAP)
.
Blok status
Bidang Informasi diatur ke jumlah byte yang dikembalikan. Bidang Status diatur ke STATUS_SUCCESS, atau mungkin ke STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER, atau STATUS_NOT_SUPPORTED.
Keterangan
Untuk reboot, efek IOCTL_STORAGE_DEVICE_POWER_CAP tidak persisten. Untuk reset perangkat NVMe/siklus daya, efek IOCTL tetap ada.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 |
Server minimum yang didukung | Server Windows 2016 |
Header | ntddstor.h (termasuk Ntddstor.h) |