Функция SetProcessDpiAwarenessContext (winuser.h)

Статья
05/20/2023

Задает для текущего процесса заданные точки на дюйм (точек на дюйм) контекста осведомленности. Контексты осведомленности о DPI относятся к значению DPI_AWARENESS_CONTEXT .

Примечание

Рекомендуется задавать уровень осведомленности о DPI по умолчанию процесса с помощью манифеста приложения, а не вызова API. Дополнительные сведения см. в разделе Настройка сведений о DPI по умолчанию для процесса . Настройка определения DPI по умолчанию процесса с помощью вызова API может привести к непредвиденному поведению приложения.

Синтаксис

BOOL SetProcessDpiAwarenessContext(
  [in] DPI_AWARENESS_CONTEXT value
);

Параметры

[in] value

Заданный дескриптор DPI_AWARENESS_CONTEXT .

Возвращаемое значение

Эта функция возвращает значение TRUE, если операция была успешной, и false в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Возможные ошибки ERROR_INVALID_PARAMETER для недопустимых входных данных и ERROR_ACCESS_DENIED , если для процесса уже задан режим осведомленности API по умолчанию (с помощью предыдущего вызова API или в манифесте приложения).

Этот API является более сложной версией ранее существующего API SetProcessDpiAwareness , что позволяет задать для процесса по умолчанию более детализированные значения DPI_AWARENESS_CONTEXT . Самое главное, это позволяет программно задать значение по умолчанию для каждого монитора версии 2 , что невозможно в предыдущем API.

Этот метод задает DPI_AWARENESS_CONTEXT по умолчанию для всех потоков в приложении. Сведения о DPI отдельных потоках могут быть изменены по сравнению со значением по умолчанию с помощью метода SetThreadDpiAwarenessContext .

Этот API необходимо вызвать перед вызовом любых API, которые зависят от осведомленности о DPI (в том числе перед созданием пользовательского интерфейса в процессе). После настройки осведомленности об API для приложения все последующие вызовы этого API будут завершатся ошибкой. Это верно независимо от того, задали ли вы осведомленность о DPI в манифесте или с помощью этого API.

Если уровень осведомленности о DPI не задан, значение по умолчанию — DPI_AWARENESS_CONTEXT_UNAWARE.

Требования


Минимальная версия клиента	Windows 10, версия 1703 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	winuser.h
Библиотека	User32.lib
DLL	User32.dll

См. также раздел

DPI_AWARENESS_CONTEXT

SetThreadDpiAwarenessContext

Настройка осведомленности о DPI по умолчанию для процесса