IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL(hpmi.h)

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

[일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적 또는 묵시적 보증을 하지 않습니다.]

HPMI로 전송된 명령을 설정하여 배터리 사용률 힌트를 제공합니다.

중요 예비 정보

주 코드

입력 버퍼

IRP(I/O 요청 패킷)의 ASSOCIATedIrp.SystemBuffer 멤버는 요청의 입력 버퍼 및 출력 버퍼로 사용되는 초기자 할당 버퍼를 가리킵니다. 입력 시 이 버퍼에는 버전이 유효한 값으로 설정된 HPMI_BATTERY_UTILIZATION_HINT 구조체가 포함됩니다.

입력 버퍼 길이

IRP의 현재 I/O 스택 위치(IO_STACK_LOCATION)의 Parameters.DeviceIoControl.InputBufferLength 멤버는 ASSOCIATedIrp.SystemBuffer 멤버가 가리키는 버퍼의 크기(바이트)로 설정됩니다. 이 크기는 sizeof HPMI_BATTERY_UTILIZATION_HINT 구조체보다 크거나 같아야 합니다. 그렇지 않으면 STATUS_INVALID_PARAMETER 오류 상태로 요청이 실패합니다.

출력 버퍼

TBD

출력 버퍼 길이

TBD

입력/출력 버퍼

TBD

입력/출력 버퍼 길이

TBD

상태 블록

요청이 성공하면 Irp->IoStatus.Status가 STATUS_SUCCESS 설정됩니다. 그렇지 않으면 NTSTATUS 코드로 적절한 오류 조건에 대한 상태(예: STATUS_INVALID_PARAMETER)입니다.

설명

HPMI가 HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS 서비스를 요청하는 경우 이 IOCTL이 여러 번 발급될 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows 10 버전 1709 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더	hpmi.h(Hpmi.h 포함)