Función SystemParametersInfoForDpi (winuser.h)

  • Artículo

Recupera el valor de uno de los parámetros de todo el sistema, teniendo en cuenta el valor de PPP proporcionado.

Sintaxis

BOOL SystemParametersInfoForDpi(
  [in]      UINT  uiAction,
  [in]      UINT  uiParam,
  [in, out] PVOID pvParam,
  [in]      UINT  fWinIni,
  [in]      UINT  dpi
);

Parámetros

[in] uiAction

Parámetro de todo el sistema que se va a recuperar. Esta función solo está pensada para su uso con SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS o SPI_GETNONCLIENTMETRICS. Consulte SystemParametersInfo para obtener más información sobre estos valores.

[in] uiParam

Parámetro cuyo uso y formato dependen del parámetro del sistema que se consulta. Para obtener más información sobre los parámetros de todo el sistema, consulte el parámetro uiAction . Si no se indica lo contrario, debe especificar cero para este parámetro.

[in, out] pvParam

Parámetro cuyo uso y formato dependen del parámetro del sistema que se consulta. Para obtener más información sobre los parámetros de todo el sistema, consulte el parámetro uiAction . Si no se indica lo contrario, debe especificar NULL para este parámetro. Para obtener información sobre el tipo de datos PVOID , vea Tipos de datos de Windows.

[in] fWinIni

No tiene ningún efecto para con esta API. Este parámetro solo tiene un efecto si va a establecer el parámetro .

[in] dpi

PPP que se va a usar para escalar la métrica.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función devuelve un resultado similar a SystemParametersInfo, pero lo escala según un PPP arbitrario que proporcione (si procede). Solo se escala con los siguientes valores posibles para uiAction: SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS, SPI_GETNONCLIENTMETRICS. Otros valores uiAction posibles no proporcionan el comportamiento forDPI y, por lo tanto, esta función devuelve 0 si se llama con ellos.

En el caso de los valores uiAction que contienen cadenas dentro de sus estructuras asociadas, solo se admiten cadenas Unicode (LOGFONTW) en esta función.

Requisitos

   
Cliente mínimo compatible Windows 10, versión 1607 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll