IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL (winioctl.h)

Windows 應用程式可以使用此控制程式代碼來指定存放裝置的最大操作耗電量等級。 OS 會最好將裝置轉換成電源狀態，但不會超過指定的最大值。 不過，這取決於裝置支援的內容。 實際最大值可能小於或大於所需的最大值。

若要執行這項作業，請使用下列參數呼叫 DeviceIoControl 函 式。

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to device
  IOCTL_STORAGE_DEVICE_POWER_CAP,   // dwIoControlCode
  (LPDWORD) lpInBuffer,             // input buffer
  (DWORD) nInBufferSize,            // size of input buffer
  (LPDWORD) lpOutBuffer,            // output buffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

備註

此 IOCTL 會傳送至設備磁碟機，其最大電源值預期會接受驅動程式。 接著，這個 IOCTL 會傳回值，代表設備磁碟機實際上能夠達成的內容。 這個值可以等於、小於或大於原本傳送的所需值。

例如，假設有三個運作電源狀態的儲存設備磁碟機，其最大耗電量等級為 10 瓦、8 瓦和 6 瓦。 如果此 IOCTL 的呼叫端指定裝置不應該耗用超過 9 瓦，則必須選擇其 8 瓦州，因為這是它仍然小於 9 瓦的最高狀態。 如果此 IOCTL 的呼叫端指定裝置不應該耗用超過 5 瓦，則設備磁碟機會挑選 6 瓦狀態，因為 6 瓦是裝置可運作的最小值。

規格需求

最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
標頭	winioctl.h (包含 Windows.h)

另請參閱

• DeviceIoControl