IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL (ntddstor.h)

  • Artikel

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

IRP_MJ_DEVICE_CONTROL

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)

Lihat juga

IO_STATUS_BLOCK

STORAGE_DEVICE_POWER_CAP

STORAGE_DEVICE_POWER_CAP_UNITS