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 結構的輸出緩衝區。 此結構 數據 成員是陣列中的第一個成員,可能會延伸至結構的結尾。 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 (include Pep_x.h) |