IOCTL_STORAGE_DEVICE_POWER_CAP IOCTL(ntddstor.h)

아티클
02/06/2022
읽는 데 2분 걸림

드라이버는 IOCTL_STORAGE_DEVICE_POWER_CAP 사용하여 스토리지 디바이스에 대한 최대 작동 전력 소비 수준을 지정할 수 있습니다. OS는 디바이스를 지정된 최대값을 초과하지 않는 전원 상태로 전환하는 것이 가장 좋습니다. 그러나 디바이스에서 지원하는 내용에 따라 달라집니다. 실제 최대값은 원하는 최댓값보다 작거나 클 수 있습니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

Parameters.DeviceIoControl.InputBufferLength 는 Irp->AssociatedIrp.SystemBuffer에서 매개 변수 버퍼의 크기를 바이트 단위로 나타내며, >= sizeof(STORAGE_DEVICE_POWER_CAP)여야 합니다.

Irp->AssociatedIrp.SystemBuffer 에는 최대 전력을 지정하는 STORAGE_DEVICE_POWER_CAP 데이터가 포함되어 있습니다.

Parameters.DeviceIoControl.OutputBufferLength 는 Irp->AssociatedIrp.SystemBuffer에 쓸 수 있는 바이트 수를 나타냅니다. OutputBufferLength 는 sizeof(STORAGE_DEVICE_POWER_CAP)여야 합니다.

입력 버퍼 길이

의 길이입니다.

출력 버퍼

작업이 성공하면 Irp->AssociatedIrp.SystemBuffer의 출력 버퍼에 STORAGE_DEVICE_POWER_CAP 구조가 포함됩니다.

출력 버퍼 길이

상태 블록

정보 필드는 반환되는 바이트 수로 설정됩니다. 상태 필드는 STATUS_SUCCESS 또는 STATUS_INVALID_DEVICE_REQUEST, STATUS_INVALID_PARAMETER 또는 STATUS_NOT_SUPPORTED 설정됩니다.

요구 사항


지원되는 최소 클라이언트	Windows 10
지원되는 최소 서버	Windows Server 2016
헤더	ntddstor.h(Ntddstor.h 포함)

참고 항목

STORAGE_DEVICE_POWER_CAP

STORAGE_DEVICE_POWER_CAP_UNITS