Função SystemParametersInfoForDpi (winuser.h)
Recupera o valor de um dos parâmetros de todo o sistema, levando em conta o valor de DPI fornecido.
Sintaxe
BOOL SystemParametersInfoForDpi(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni,
[in] UINT dpi
);
Parâmetros
[in] uiAction
O parâmetro de todo o sistema a ser recuperado. Essa função destina-se apenas ao uso com SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICS ou SPI_GETNONCLIENTMETRICS. Consulte SystemParametersInfo para obter mais informações sobre esses valores.
[in] uiParam
Um parâmetro cujo uso e formato dependem do parâmetro do sistema que está sendo consultado. Para obter mais informações sobre parâmetros em todo o sistema, consulte o parâmetro uiAction . Se não for indicado de outra forma, você deverá especificar zero para esse parâmetro.
[in, out] pvParam
Um parâmetro cujo uso e formato dependem do parâmetro do sistema que está sendo consultado. Para obter mais informações sobre parâmetros em todo o sistema, consulte o parâmetro uiAction . Se não for indicado de outra forma, você deverá especificar NULL para esse parâmetro. Para obter informações sobre o tipo de dados PVOID , consulte Tipos de dados do Windows.
[in] fWinIni
Não tem nenhum efeito para com essa API. Esse parâmetro só terá efeito se você estiver definindo o parâmetro .
[in] dpi
O DPI a ser usado para dimensionar a métrica.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Essa função retorna um resultado semelhante a SystemParametersInfo, mas o dimensiona de acordo com um DPI arbitrário fornecido (se apropriado). Ele só é dimensionado com os seguintes valores possíveis para uiAction: SPI_GETICONTITLELOGFONT, SPI_GETICONMETRICSSPI_GETNONCLIENTMETRICS. Outros valores possíveis de uiAction não fornecem o comportamento de ForDPI e, portanto, essa função retorna 0 se chamada com eles.
Para valores uiAction que contêm cadeias de caracteres dentro de suas estruturas associadas, somente cadeias de caracteres Unicode (LOGFONTW) têm suporte nessa função.
Requisitos
Cliente mínimo com suporte | Windows 10, versão 1607 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | winuser.h (inclua Windows.h) |
Biblioteca | User32.lib |
DLL | User32.dll |