IOCTL_HPMI_BATTERY_UTILIZATION_HINT IOCTL (hpmi.h)
[一部の情報は、商用リリース前に大幅に変更される可能性があるプレリリース製品に関連しています。 Microsoft は、ここで提供される情報に関して明示的または黙示的な保証を行いません。
HPMI に送信されるコマンドを設定して、バッテリ使用率のヒントを提供します。
メジャー コード
入力バッファー
I/O 要求パケット (IRP) の AssociatedIrp.SystemBuffer メンバーは、入力バッファーと要求の出力バッファーの両方として使用されるイニシエーターによって割り当てられたバッファーを指します。 入力時に、このバッファーには、バージョンが有効な値に設定されている HPMI_BATTERY_UTILIZATION_HINT 構造体が含まれます。
入力バッファーの長さ
IRP の現在の I/O スタック位置 (IO_STACK_LOCATION) の Parameters.DeviceIoControl.InputBufferLength メンバーは、AssociatedIrp.SystemBuffer メンバーが指すバッファーのサイズ (バイト単位) に設定されます。 このサイズは、HPMI_BATTERY_UTILIZATION_HINT 構造体の sizeof 以上である必要があります。または、要求はエラー状態が STATUS_INVALID_PARAMETER で失敗します。
出力バッファー
未定
出力バッファーの長さ
未定
入力/出力バッファー
未定
入力/出力バッファーの長さ
未定
状態ブロック
Irp->IoStatus.Status は、要求が成功した場合にSTATUS_SUCCESSに設定されます。 それ以外の場合は、STATUS_INVALID_PARAMETERなど、NTSTATUS コードとして適切なエラー条件に 状態を します。
備考
HPMI がサービスを要求した場合、この IOCTL HPMI_REQUEST_SERVICE_BATTERY_UTILIZATION_HINTS複数回発行される場合があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 バージョン 1709 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | hpmi.h (Hpmi.h を含む) |
関連項目
ドライバー での IOCTL 要求の作成の
IOCTL_HPMI_BATTERY_UTILIZATION_HINT
WdfIoTargetSendInternalIoctlOthersSynchronously を する
WdfIoTargetSendInternalIoctlSynchronously
WdfIoTargetSendIoctlSynchronously を する
hpmi.h を する