GetProcessDpiAwareness function (shellscalingapi.h)

Retrieves the dots per inch (dpi) awareness of the specified process.

Syntax

HRESULT GetProcessDpiAwareness(
  [in]  HANDLE                hprocess,
  [out] PROCESS_DPI_AWARENESS *value
);

Parameters

[in] hprocess

Handle of the process that is being queried. If this parameter is NULL, the current process is queried.

[out] value

The DPI awareness of the specified process. Possible values are from the PROCESS_DPI_AWARENESS enumeration.

Return value

This function returns one of the following values.

Return code	Description
S_OK	The function successfully retrieved the DPI awareness of the specified process.
E_INVALIDARG	The handle or pointer passed in is not valid.
E_ACCESSDENIED	The application does not have sufficient privileges.

Remarks

This function is identical to the following code:

GetAwarenessFromDpiAwarenessContext(GetThreadDpiAwarenessContext());

Requirements

Requirement	Value
Minimum supported client	Windows 8.1 [desktop apps only]
Minimum supported server	Windows Server 2012 R2 [desktop apps only]
Target Platform	Windows
Header	shellscalingapi.h
Library	Shcore.lib
DLL	Shcore.dll

See also

GetAwarenessFromDpiAwarenessContext

GetThreadDpiAwarenessContext

PROCESS_DPI_AWARENESS