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) |