PEP_POWER_CONTROL_REQUEST 構造体 (pep_x.h)

PEP_POWER_CONTROL_REQUEST構造体には、電源制御操作のドライバーからの要求が含まれています。

構文

typedef struct _PEP_POWER_CONTROL_REQUEST {
  [in]  PEPHANDLE DeviceHandle;
  [in]  LPCGUID   PowerControlCode;
  [in]  PVOID     InBuffer;
  [in]  SIZE_T    InBufferSize;
  [in]  PVOID     OutBuffer;
  [in]  SIZE_T    OutBufferSize;
  [out] SIZE_T    BytesReturned;
  [out] NTSTATUS  Status;
} PEP_POWER_CONTROL_REQUEST, *PPEP_POWER_CONTROL_REQUEST;

メンバー

[in] DeviceHandle

デバイスを識別する PEPHANDLE 値。 PEP は、以前のPEP_DPM_REGISTER_DEVICE通知に応答してこのハンドル を 提供しました。

[in] PowerControlCode

実行する電源制御操作を指定する GUID 値へのポインター。 これは、要求側ドライバーが PowerControlCode パラメーターとして PoFxPowerControl ルーチンに指定した値と同じです。

[in] InBuffer

この電源制御操作の入力パラメーターを含む、ドライバーによって割り当てられた入力バッファーへのポインター。 これは、要求側ドライバーが PoFxPowerControl ルーチンに InBuffer パラメーターとして指定したのと同じ値です。

[in] InBufferSize

InBuffer が指すバッファーのサイズ (バイト単位)。 これは、要求側ドライバーが PoFxPowerControl ルーチンに InBufferSize パラメーターとして指定したのと同じ値です。

[in] OutBuffer

PEP がこの電源制御操作の結果を書き込む、ドライバーによって割り当てられた出力バッファーへのポインター。 これは、要求側ドライバーが PoFxPowerControl ルーチンに OutBuffer パラメーターとして指定したのと同じ値です。

[in] OutBufferSize

OutBuffer が指すバッファーのサイズ (バイト単位)。

[out] BytesReturned

OUTBuffer が指す出力バッファーに PEP が書き込んだバイト数。

[out] Status

要求された電源制御操作の状態。 操作が成功した場合、PEP はこのメンバーをSTATUS_SUCCESSに設定します。 それ以外の場合、PEP はこのメンバーを適切なエラー状態コードに設定します。

注釈

この構造体は、 PEP_DPM_POWER_CONTROL_REQUEST 通知によって使用されます。 構造体の最初の 6 つのメンバーには、Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれています。 最後の 2 つのメンバーには、この通知に応答して PEP が 構造体に書き込む値が含まれています。 さらに、PEP は OutBuffer メンバーが指す出力バッファーに書き込みます。

出力バッファーが小さすぎて操作からすべての結果データを受信できない場合、PEP は構造体の Status メンバーをSTATUS_INSUFFICIENT_RESOURCESに設定し、 BytesReturned メンバーを出力バッファーの必要なサイズに設定し、(通常は) 出力バッファーにデータを書き込まない。

デバイスのドライバーは、 PoFxPowerControl ルーチンを呼び出して、デバイスの電源制御操作を要求できます。 この呼び出し中に、PoFx はデバイスを所有する PEP にこの要求の処理を委任します。 PEP_POWER_CONTROL_REQUEST構造体の PowerControlCode メンバーには、デバイスのドライバーと PEP の両方で意味が理解されるカスタム コントロール コードが含まれています。

要件

こちらもご覧ください

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl