PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES結構 (pepfx.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

PEPHANDLE 值，可識別裝置的 ACPI 服務註冊。 平臺擴充功能外掛程式 (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_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES 通知傳送給此裝置的 PEP。

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
標頭 pepfx.h (包含 Pep_x.h)

另請參閱

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE