PEP_POWER_CONTROL_COMPLETE構造体 (pep_x.h)

PEP_POWER_CONTROL_COMPLETE構造体には、PEP が以前に要求し、デバイス ドライバーが完了した電源制御操作の状態情報が含まれています。

構文

typedef struct _PEP_POWER_CONTROL_COMPLETE {
  [in] PEPHANDLE DeviceHandle;
  [in] LPCGUID   PowerControlCode;
  [in] PVOID     RequestContext;
  [in] SIZE_T    BytesReturned;
  [in] NTSTATUS  Status;
} PEP_POWER_CONTROL_COMPLETE, *PPEP_POWER_CONTROL_COMPLETE;

メンバー

[in] DeviceHandle

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

[in] PowerControlCode

実行された電源制御操作を指定する GUID 値へのポインター。 これは、電源制御操作を開始する PEP_DPM_WORK 通知に応答して PEP が指定した値と同じです。

[in] RequestContext

PEP が元の作業要求で指定した PEP_WORK_INFORMATION 構造体で PEP によって送信された要求コンテキストへのポインター。 通常、このメンバーは、PEP によって要求された電源制御操作の結果を格納する出力バッファーへのポインターを含む構造体を指します。

[in] BytesReturned

ドライバーによって出力バッファーに格納された結果データのサイズ (バイト単位)。 このバッファーの詳細については、 RequestContext メンバーの説明を参照してください。

[in] Status

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

注釈

この構造体は、 PEP_DPM_POWER_CONTROL_COMPLETE 通知によって使用されます。 構造体の 5 つのメンバーすべてに、 によって提供される入力値が含まれています

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

要件

こちらもご覧ください

GUID