Библиотека механизма среды выполнения платформы Windows Kernel-Mode (PRM)

Механизм среды выполнения платформы (PRM) — это интерфейс GUID, который позволяет драйверам выполнять обработчики, предварительно загруженные в прошивку UEFI (Unified Extensible Firmware Interface). PRM предлагает функциональные возможности, аналогичные вызовам прерываний управления системой (SMI) в режиме управления системой (SMM), но PRM более безопасен.

Во время выполнения системы встроенное ПО может содержать несколько модулей PRM, каждый из которых имеет уникальный набор обработчиков.

Драйверы могут вызывать обработчики PRM для низкоуровневых операций, таких как управление аппаратными компонентами, управление тепловыми состояниями или расширенное управление питанием.

Выполните следующие действия, чтобы проверить доступность определенного обработчика и запустить его. Пример реализации этого процесса можно найти в примере PrmFunc.

1. Получите указатель на структуру PRM_INTERFACE путем вызова функции ExGetPrmInterface. Эта структура содержит указатели на подпрограммы операций PRM.

2. Синхронизация с потенциальными обновлениями среды выполнения в модуле PRM путем вызова подпрограммы PRM_LOCK_MODULE . Для транзакционных вызовов обработчика PRM рекомендуется блокировка и разблокировка, и в целом их советуют использовать.

3. Проверьте наличие обработчика PRM, используя подпрограмму PRM_QUERY_HANDLER.

4. Если запрос выполнен успешно, вызовите обработчик PRM, вызвав подпрограмму PRM_INVOKE_HANDLER . Укажите GUID и буфер параметров, который должен содержать параметры обработчика PRM. Выходной параметр EfiStatus указывает состояние вызова обработчика.

5. Если вы ранее вызвали PRM_LOCK_MODULE, освободите интерфейсный объект PRM, вызвав подпрограмму PRM_UNLOCK_MODULE.

См. также

Дополнительные сведения см. в спецификации PRM.