PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 構造体 (pep_x.h)

PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES構造体には、デバイスの電源を制御するために必要な生リソースの一覧が含まれています。

構文

typedef struct _PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES {
  [in]      PEPHANDLE            DeviceHandle;
  [in]      ULONG                RequestFlags;
  [out]     NTSTATUS             Status;
  [in, out] SIZE_T               BiosResourcesSize;
            ACPI_METHOD_ARGUMENT BiosResources[ANYSIZE_ARRAY];
} PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES, *PPEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES;

メンバー

[in] DeviceHandle

ACPI サービスに対するデバイスの登録を識別する PEPHANDLE 値。 プラットフォーム拡張機能プラグイン (PEP) は、以前の PEP_NOTIFY_ACPI_REGISTER_DEVICE 通知に応答してこのハンドルを提供しました。

[in] RequestFlags

入力フラグのセット。 現在、このメンバーにはフラグは定義されていません。これは常に PEP_ACPI_QDCR_FLAG_NONE (0x0) に設定されます。

[out] Status

このクエリの状態を示す NTSTATUS 値。 PEP が要求されたリソースの一覧の提供に成功した場合は、このメンバーを STATUS_SUCCESS に設定します。 出力バッファーがリソース リストを格納するのに十分な大きさではないことを示すには、STATUS_BUFFER_TOO_SMALL に設定します。

[in, BiosResourcesSize

入力時に、 BiosResources メンバーに割り当てられたバッファーのサイズ (バイト単位)。 このバッファー サイズには、このメンバーに続く可能性のある関連データが含まれます。

このバッファーが 、ACPI_METHOD_ARGUMENT 構造体とそれに関連付けられているデータを格納するのに十分な大きさでない場合、PEP は BiosResourcesSize の入力値を必要なサイズで上書きし、 Status メンバーをSTATUS_BUFFER_TOO_SMALLに設定します。

[in] BiosResources[ANYSIZE_ARRAY]

PEP が要求されたリソース リストを含む ACPI_METHOD_ARGUMENT 構造体を書き込む出力バッファー。 この構造体の Data メンバーは、構造体の末尾を越えて拡張される可能性がある配列の最初のメンバーです。 BiosResourcesSize で指定されたバッファー サイズには、ACPI_METHOD_ARGUMENT構造体と、この構造体に続く Data 配列要素の両方が含まれます。

注釈

この構造体は、 PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 通知によって使用されます。 構造体の RequestFlags、 BiosResourcesSize、 および BiosResources の各メンバーには、この通知の送信時に Windows 電源管理フレームワーク (PoFx) によって提供される入力値が含まれます。 BiosResourcesSize 入力値が小さすぎる場合は、PEP によってこの値が上書きされます。 Status メンバーには、PEP が通知に応答してこの構造体に書き込む出力値が含まれています。

BiosResourcesSize メンバーで指定された入力値が必要なサイズより小さい場合、PEP は BiosResourcesSize 入力値を必要なサイズで上書きし、Status メンバーをSTATUS_BUFFER_TOO_SMALLに設定します。 これに対して、PoFx は必要なサイズのバッファーを割り当て、このデバイスの PEP に 2 つ目の PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 通知を送信しようとします。

要件

こちらもご覧ください

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE