struktur PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES (pepfx.h)

  • Artikel

Struktur PEP_ACPI_QUERY_DEVICE_CONTROL_RESOURCES berisi daftar sumber daya mentah yang diperlukan untuk mengontrol daya ke perangkat.

Sintaks

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;

Anggota

[in] DeviceHandle

Nilai PEPHANDLE yang mengidentifikasi pendaftaran perangkat untuk layanan ACPI. Plug-in ekstensi platform (PEP) menyediakan handel ini sebagai respons terhadap pemberitahuan PEP_NOTIFY_ACPI_REGISTER_DEVICE sebelumnya.

[in] RequestFlags

Sekumpulan bendera input. Tidak ada bendera yang saat ini ditentukan untuk anggota ini, yang selalu diatur ke PEP_ACPI_QDCR_FLAG_NONE (0x0).

[out] Status

Nilai NTSTATUS yang menunjukkan status kueri ini. Atur anggota ini ke STATUS_SUCCESS jika PEP berhasil menyediakan daftar sumber daya yang diminta. Atur ke STATUS_BUFFER_TOO_SMALL untuk menunjukkan bahwa buffer output tidak cukup besar untuk berisi daftar sumber daya.

[in, BiosResourcesSize

Pada input, ukuran, dalam byte, dari buffer yang dialokasikan untuk anggota BiosResources . Ukuran buffer ini mencakup data terkait yang mungkin mengikuti anggota ini.

Jika buffer ini tidak cukup besar untuk berisi struktur ACPI_METHOD_ARGUMENT dan data terkaitnya, PEP menimpa nilai input BiosResourcesSize dengan ukuran yang diperlukan dan mengatur anggota Status ke STATUS_BUFFER_TOO_SMALL.

[in] BiosResources[ANYSIZE_ARRAY]

Buffer output tempat PEP menulis struktur ACPI_METHOD_ARGUMENT yang berisi daftar sumber daya yang diminta. Anggota Data dari struktur ini adalah anggota pertama dalam array yang mungkin meluas melewati akhir struktur. Ukuran buffer yang ditentukan oleh BiosResourcesSize mencakup struktur ACPI_METHOD_ARGUMENT dan elemen array Data apa pun yang mengikuti struktur ini.

Keterangan

Struktur ini digunakan oleh pemberitahuan PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES . Anggota RequestFlags, BiosResourcesSize, dan BiosResources dari struktur berisi nilai input yang disediakan oleh kerangka kerja manajemen daya Windows (PoFx) saat pemberitahuan ini dikirim. Jika nilai input BiosResourcesSize terlalu kecil, PEP harus menimpa nilai ini. Anggota Status berisi nilai output yang ditulis PEP ke struktur ini sebagai respons terhadap pemberitahuan.

Jika nilai input yang ditentukan dalam anggota BiosResourcesSize kurang dari ukuran yang diperlukan, PEP menimpa nilai input BiosResourcesSize dengan ukuran yang diperlukan, dan mengatur anggota Status ke STATUS_BUFFER_TOO_SMALL. Sebagai respons, PoFx akan mencoba mengalokasikan buffer dengan ukuran yang diperlukan dan mengirim pemberitahuan PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES kedua ke PEP untuk perangkat ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 10.
Header pepfx.h (termasuk Pep_x.h)

Lihat juga

ACPI_METHOD_ARGUMENT

PEP_NOTIFY_ACPI_QUERY_DEVICE_CONTROL_RESOURCES

PEP_NOTIFY_ACPI_REGISTER_DEVICE