다음을 통해 공유


SystemParametersInfoA 함수(winuser.h)

중요

일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

시스템 전체 매개 변수 중 하나의 값을 검색하거나 설정합니다. 이 함수는 매개 변수를 설정하는 동안 사용자 프로필을 업데이트할 수도 있습니다.

구문

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

매개 변수

[in] uiAction

형식: UINT

검색하거나 설정할 시스템 전체 매개 변수입니다. 가능한 값은 다음 관련 매개 변수 테이블에서 구성됩니다.

  • 접근성 매개 변수
  • 데스크톱 매개 변수
  • 아이콘 매개 변수
  • 입력 매개 변수
  • 메뉴 매개 변수
  • 전원 매개 변수
  • 화면 보호기 매개 변수
  • 시간 제한 매개 변수
  • UI 효과 매개 변수
  • 창 매개 변수

다음은 접근성 매개 변수입니다.

접근성 매개 변수 의미
SPI_GETACCESSTIMEOUT
0x003C
접근성 기능과 관련된 제한 시간에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 ACCESSTIMEOUT 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ACCESSTIMEOUT)설정합니다.
SPI_GETAUDIODESCRIPTION
0x0074
오디오 설명을 사용할지 여부를 결정합니다. pvParam 매개 변수는 AUDIODESCRIPTION 구조체에 대한 포인터입니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(AUDIODESCRIPTION)설정합니다.

시각 장애가 있는 사용자가 비디오 콘텐츠에서 오디오를 들을 수 있지만 비디오에는 해당 오디오가 없는 많은 작업이 있습니다. 비디오에서 발생하는 일에 대한 특정 오디오 설명은 이러한 사용자가 콘텐츠를 더 잘 이해하는 데 도움이 됩니다. 이 플래그를 사용하면 오디오 설명이 사용하도록 설정되었는지 여부와 언어를 확인할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETCLIENTAREAANIMATION
0x1042
애니메이션을 사용할지 여부를 결정합니다. pvParam 매개 변수는 애니메이션이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.

깜박임, 깜박임, 깜박임 및 콘텐츠 이동과 같은 표시 기능은 사진에 민감한 간질을 가진 사용자에게 발작을 일으킬 수 있습니다. 이 플래그를 사용하면 클라이언트 영역에서 이러한 애니메이션이 비활성화되었는지 여부를 확인할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETDISABLEOVERLAPPEDCONTENT
0x1040
겹치는 콘텐츠의 사용 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다.

배경 이미지, 질감이 있는 배경, 문서의 워터 마크, 알파 혼합 및 투명도와 같은 표시 기능은 전경과 배경 간의 대비를 줄여 시력이 낮은 사용자가 화면에서 개체를 보기 어렵게 만들 수 있습니다. 이 플래그를 사용하면 겹치는 콘텐츠가 비활성화되었는지 여부를 확인할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETFILTERKEYS
0x0032
FilterKeys 접근성 기능에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 FILTERKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(FILTERKEYS)설정합니다.
SPI_GETFOCUSBORDERHEIGHT
0x2010
DrawFocusRect로 그린 포커스 사각형의 위쪽 및 아래쪽 가장자리 높이를 픽셀 단위로 검색합니다. pvParam 매개 변수는 UINT 값을 가리킵니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETFOCUSBORDERWIDTH
0x200E
DrawFocusRect로 그린 포커스 사각형의 왼쪽 및 오른쪽 가장자리 너비를 픽셀 단위로 검색합니다. pvParam 매개 변수는 UINT를 가리킵니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETHIGHCONTRAST
0x0042
HighContrast 접근성 기능에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 HIGHCONTRAST 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(HIGHCONTRAST)설정합니다.

일반적인 토론은 비고를 참조하세요.

SPI_GETLOGICALDPIOVERRIDE
0x009E
Windows 8이 하드웨어에 대한 기본 크기 조정 고원을 사용하여 앱을 표시하는지 아니면 다음 상위 고원으로 가는지를 결정하는 값을 검색합니다. 이 값은 PC 설정의 접근성 섹션에 있는 현재 "화면의 모든 항목을 더 크게 만들기" 설정을 기반으로 합니다. 1이 켜져 있으며 0이 꺼져 있습니다.

앱은 각각 100%, 140%, 180%의 여러 크기 조정 고원에 대한 텍스트 및 이미지 리소스를 제공할 수 있습니다. 특정 규모에 최적화된 별도의 리소스를 제공하면 크기 조정으로 인한 왜곡을 방지할 수 있습니다. Windows 8은 화면 크기 및 픽셀 밀도를 비롯한 다양한 요인에 따라 적절한 크기 조정 고원을 결정합니다. "화면의 모든 항목을 더 크게 만들기"가 선택되면(SPI_GETLOGICALDPIOVERRIDE 값 1을 반환함) Windows는 다음 상위 고원의 리소스를 사용합니다. 예를 들어 Windows에서 SCALE_100_PERCENT 스케일을 사용해야 한다고 결정하는 하드웨어의 경우 이 재정의를 통해 Windows는 다른 제약 조건을 위반하지 않는다고 가정하여 SCALE_140_PERCENT 크기 조정 값을 사용합니다.

참고 이 값을 사용하면 안 됩니다. 이후 버전의 Windows에서 변경되거나 사용할 수 없을 수 있습니다. 대신 GetScaleFactorForDevice 함수 또는 DisplayProperties 클래스를 사용하여 기본 크기 조정 요소를 검색합니다. 데스크톱 애플리케이션은 배율 대신 데스크톱 논리 DPI를 사용해야 합니다. 데스크톱 논리 DPI는 GetDeviceCaps 함수를 통해 검색할 수 있습니다.
 
SPI_GETMESSAGEDURATION
0x2016
알림 팝업이 표시되어야 하는 시간(초)을 검색합니다. pvParam 매개 변수는 메시지 기간을 수신하는 ULONG을 가리킵니다.

시각 장애가 있거나 ADHD 및 난독증과 같은 인지 조건이 있는 사용자는 알림 메시지에서 텍스트를 읽는 데 시간이 더 오래 필요할 수 있습니다. 이 플래그를 사용하면 메시지 기간을 검색할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSECLICKLOCK
0x101E
마우스 클릭 잠금 기능의 상태를 검색합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSECLICKLOCKTIME
0x2008
기본 마우스 단추가 잠기기 전의 시간 지연을 검색합니다. pvParam 매개 변수는 시간 지연을 수신하는 DWORD(밀리초)를 가리킵니다. SPI_SETMOUSECLICKLOCK TRUE설정된 경우에만 사용하도록 설정됩니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSEKEYS
0x0036
MouseKeys 접근성 기능에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 MOUSEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(MOUSEKEYS)설정합니다.
SPI_GETMOUSESONAR
0x101C
마우스 수중 음파 탐지기 기능의 상태를 검색합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSEVANISH
0x1020
마우스 소실 기능의 상태를 검색합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETSCREENREADER
0x0046
화면 검토자 유틸리티가 실행 중인지 여부를 확인합니다. 화면 검토자 유틸리티는 음성 신시사이저 또는 점자 디스플레이와 같은 출력 디바이스에 텍스트 정보를 전달합니다. 이 플래그가 설정되면 애플리케이션은 그렇지 않으면 정보를 그래픽으로 표시하는 상황에서 텍스트 정보를 제공해야 합니다.

pvParam 매개 변수는 화면 검토자 유틸리티가 실행 중인 경우 TRUE를 수신하는 BOOL 변수에 대한 포인터이거나 그렇지 않으면 FALSE입니다.

참고 Windows에 포함된 화면 읽기 프로그램인 내레이터는 SPI_SETSCREENREADER 또는 SPI_GETSCREENREADER 플래그를 설정하지 않습니다.
 
SPI_GETSERIALKEYS
0x003E
이 매개 변수는 지원되지 않습니다.

Windows Server 2003 및 Windows XP/2000: 사용자는 제어판을 통해 이 설정을 제어해야 합니다.

SPI_GETSHOWSOUNDS
0x0038
소리 표시 접근성 플래그가 켜지거나 꺼져 있는지 여부를 확인합니다. 이 설정이 켜진 경우 사용자는 애플리케이션이 정보를 가청 형식으로만 제공하는 상황에서 시각적으로 정보를 표시하도록 요구합니다. pvParam 매개 변수는 기능이 켜져 있으면 TRUE를 수신하는 BOOL 변수를 가리키고, 해제된 경우 FALSE를 가리킵니다.

이 값을 사용하는 것은 SM_SHOWSOUNDSGetSystemMetrics를 호출하는 것과 같습니다. 이것이 권장되는 호출입니다.

SPI_GETSOUNDSENTRY
0x0040
SoundSentry 접근성 기능에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 SOUNDSENTRY 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(SOUNDSENTRY)설정합니다.
SPI_GETSTICKYKEYS
0x003A
StickyKeys 접근성 기능에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 STICKYKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(STICKYKEYS)설정합니다.
SPI_GETTOGGLEKEYS
0x0034
ToggleKeys 접근성 기능에 대한 정보를 검색합니다. pvParam 매개 변수는 정보를 수신하는 TOGGLEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(TOGGLEKEYS)설정합니다.
SPI_SETACCESSTIMEOUT
0x003D
접근성 기능과 관련된 제한 시간을 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 ACCESSTIMEOUT 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ACCESSTIMEOUT)설정합니다.
SPI_SETAUDIODESCRIPTION
0x0075
오디오 설명 기능을 켜거나 끕니다. pvParam 매개 변수는 AUDIODESCRIPTION 구조체에 대한 포인터입니다.

시각 장애가 있는 사용자가 비디오 콘텐츠에서 오디오를 들을 수 있지만, 비디오에는 해당 오디오가 없는 많은 작업이 있습니다. 비디오에서 발생하는 일에 대한 특정 오디오 설명은 이러한 사용자가 콘텐츠를 더 잘 이해하는 데 도움이 됩니다. 이 플래그를 사용하면 제공된 언어로 오디오 설명을 사용하거나 사용하지 않도록 설정할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETCLIENTAREAANIMATION
0x1043
클라이언트 영역 애니메이션을 켜거나 끕니다. pvParam 매개 변수는 BOOL 변수입니다. pvParamTRUE로 설정하여 클라이언트 영역에서 애니메이션 및 기타 일시적인 효과를 사용하도록 설정하거나 FALSE를 사용하여 애니메이션을 사용하지 않도록 설정합니다.

깜박임, 깜박임, 깜박임 및 콘텐츠 이동과 같은 표시 기능은 사진에 민감한 간질을 가진 사용자에게 발작을 일으킬 수 있습니다. 이 플래그를 사용하면 이러한 모든 애니메이션을 사용하거나 사용하지 않도록 설정할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETDISABLEOVERLAPPEDCONTENT
0x1041
겹치는 콘텐츠(예: 배경 이미지 및 워터마크)를 켜거나 끕니다. pvParam 매개 변수는 BOOL 변수입니다. 겹치는 콘텐츠를 사용하지 않도록 설정하려면 pvParamTRUE 로 설정하고, 겹치는 콘텐츠를 사용하도록 설정하려면 FALSE 를 설정합니다.

배경 이미지, 질감이 있는 배경, 문서의 워터 마크, 알파 혼합 및 투명도와 같은 표시 기능은 전경과 배경 간의 대비를 줄여 시력이 낮은 사용자가 화면에서 개체를 보기 어렵게 만들 수 있습니다. 이 플래그를 사용하면 이러한 겹치는 모든 콘텐츠를 사용하거나 사용하지 않도록 설정할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETFILTERKEYS
0x0033
FilterKeys 접근성 기능의 매개 변수를 설정합니다. pvParam 매개 변수는 새 매개 변수가 포함된 FILTERKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(FILTERKEYS)설정합니다.
SPI_SETFOCUSBORDERHEIGHT
0x2011
DrawFocusRect로 그린 포커스 사각형의 위쪽 및 아래쪽 가장자리 높이를 pvParam 매개 변수 값으로 설정합니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETFOCUSBORDERWIDTH
0x200F
DrawFocusRect로 그린 포커스 사각형의 왼쪽 및 오른쪽 가장자리 높이를 pvParam 매개 변수 값으로 설정합니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETHIGHCONTRAST
0x0043
HighContrast 접근성 기능의 매개 변수를 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 HIGHCONTRAST 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(HIGHCONTRAST)설정합니다.
SPI_SETLOGICALDPIOVERRIDE
0x009F
사용하지 마십시오.
SPI_SETMESSAGEDURATION
0x2017
알림 팝업이 표시되어야 하는 시간(초)을 설정합니다. pvParam 매개 변수는 메시지 기간을 지정합니다.

시각 장애가 있거나 ADHD 및 난독증과 같은 인지 조건이 있는 사용자는 알림 메시지에서 텍스트를 읽는 데 시간이 더 오래 필요할 수 있습니다. 이 플래그를 사용하면 메시지 기간을 설정할 수 있습니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSECLICKLOCK
0x101F
마우스 클릭 접근성 차단 기능을 켜거나 끕니다. 이 기능은 해당 단추를 클릭하고 SPI_SETMOUSECLICKLOCKTIME 지정된 시간 동안 누른 상태에서 기본 마우스 단추를 일시적으로 잠가 둡니다. pvParam 매개 변수는 on에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. 기본값은 off입니다. 자세한 내용은 설명 및 정보문자 입력을 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSECLICKLOCKTIME
0x2009
기본 마우스 단추가 잠기기 전에 시간 지연을 조정합니다. uiParam 매개 변수는 0으로 설정해야 합니다. pvParam 매개 변수는 시간 지연을 밀리초 단위로 지정하는 DWORD를 가리킵니다. 예를 들어 1초 지연에 대해 1000을 지정합니다. 기본값은 1200입니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSEKEYS
0x0037
MouseKeys 접근성 기능의 매개 변수를 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 MOUSEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(MOUSEKEYS)설정합니다.
SPI_SETMOUSESONAR
0x101D
수중 음파 탐지기 접근성 기능을 켜거나 끕니다. 이 기능은 사용자가 Ctrl 키를 누르고 놓을 때 마우스 포인터 주위의 여러 동심원을 간략하게 보여줍니다. pvParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. 기본값은 off입니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSEVANISH
0x1021
소멸 기능을 켜거나 끕니다. 이 기능은 사용자가 입력할 때 마우스 포인터를 숨깁니다. 포인터는 사용자가 마우스를 이동할 때 다시 나타납니다. pvParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. 기본값은 off입니다. 자세한 내용은 마우스 입력 개요를 참조하세요.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETSCREENREADER
0x0047
화면 검토 유틸리티가 실행 중인지 여부를 확인합니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다.
참고 Windows에 포함된 화면 읽기 프로그램인 내레이터는 SPI_SETSCREENREADER 또는 SPI_GETSCREENREADER 플래그를 설정하지 않습니다.
 
SPI_SETSERIALKEYS
0x003F
이 매개 변수는 지원되지 않습니다.

Windows Server 2003 및 Windows XP/2000: 사용자는 제어판을 통해 이 설정을 제어해야 합니다.

SPI_SETSHOWSOUNDS
0x0039
ShowSounds 접근성 기능을 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다.
SPI_SETSOUNDSENTRY
0x0041
SoundSentry 접근성 기능의 매개 변수를 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 SOUNDSENTRY 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(SOUNDSENTRY)설정합니다.
SPI_SETSTICKYKEYS
0x003B
StickyKeys 접근성 기능의 매개 변수를 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 STICKYKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(STICKYKEYS)설정합니다.
SPI_SETTOGGLEKEYS
0x0035
ToggleKeys 접근성 기능의 매개 변수를 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 TOGGLEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(TOGGLEKEYS)설정합니다.
 

다음은 데스크톱 매개 변수입니다.

데스크톱 매개 변수 의미
SPI_GETCLEARTYPE
0x1048
ClearType을 사용할 수 있는지 여부를 확인합니다. pvParam 매개 변수는 ClearType이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.

ClearType은 LCD(액정 디스플레이) 모니터에서 텍스트의 가독성을 향상시키는 소프트웨어 기술입니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETDESKWALLPAPER
0x0073
바탕 화면 배경 화면의 비트맵 파일 전체 경로를 검색합니다. pvParam 매개 변수는 null로 끝나는 경로 문자열을 수신하기 위해 버퍼를 가리킵니다. uiParam 매개 변수를 pvParam 버퍼의 크기(문자)로 설정합니다. 반환된 문자열은 MAX_PATH 문자를 초과하지 않습니다. 바탕 화면 배경 화면이 없으면 반환된 문자열이 비어 있습니다.
SPI_GETDROPSHADOW
0x1024
그림자 효과를 사용할 수 있는지 여부를 확인합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 반환하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETFLATMENU
0x1022
네이티브 사용자 메뉴에 플랫 메뉴 모양이 있는지 여부를 결정합니다. pvParam 매개 변수는 플랫 메뉴 모양이 설정된 경우 TRUE를 반환하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETFONTSMOOTHING
0x004A
글꼴 다듬기 기능을 사용할 수 있는지 여부를 결정합니다. 이 기능은 글꼴 앤티앨리어싱을 사용하여 다양한 회색 수준에서 픽셀을 그리면 글꼴 곡선이 더 부드럽게 표시되도록 합니다.

pvParam 매개 변수는 기능이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고, 그렇지 않으면 FALSE를 가리킵니다.

SPI_GETFONTSMOOTHINGCONTRAST
0x200C
ClearType 다듬기에서 사용되는 대비 값을 검색합니다. pvParam 매개 변수는 정보를 수신하는 UINT를 가리킵니다. 유효한 대비 값은 1000에서 2200까지입니다. 기본값은 1400입니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETFONTSMOOTHINGORIENTATION
0x2012
글꼴 다듬기 방향을 검색합니다. pvParam 매개 변수는 정보를 수신하는 UINT를 가리킵니다. 가능한 값은 FE_FONTSMOOTHINGORIENTATIONBGR (파란색-녹색-빨간색) 및 FE_FONTSMOOTHINGORIENTATIONRGB (빨강-녹색-파란색)입니다.

Windows XP/2000: 이 매개 변수는 WINDOWS XP SP2까지 지원되지 않습니다.

SPI_GETFONTSMOOTHINGTYPE
0x200A
글꼴 다듬기 유형을 검색합니다. pvParam 매개 변수는 정보를 수신하는 UINT를 가리킵니다. 가능한 값은 FE_FONTSMOOTHINGSTANDARDFE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETWORKAREA
0x0030
기본 디스플레이 모니터에서 작업 영역의 크기를 검색합니다. 작업 영역은 시스템 작업 표시줄 또는 애플리케이션 데스크톱 도구 모음에 의해 가려지지 않는 화면의 부분입니다. pvParam 매개 변수는 실제 픽셀 크기로 표현된 작업 영역의 좌표를 수신하는 RECT 구조를 가리킵니다. 호출자의 DPI 가상화 모드는 이 출력에 영향을 주지 않습니다.

기본 디스플레이 모니터가 아닌 모니터의 작업 영역을 얻으려면 GetMonitorInfo 함수를 호출합니다.

SPI_SETCLEARTYPE
0x1049
ClearType을 켜거나 끕니다. pvParam 매개 변수는 BOOL 변수입니다. ClearType을 사용하도록 설정하려면 pvParamTRUE 로 설정하고 FALSE를 설정 하여 사용하지 않도록 설정합니다.

ClearType은 LCD 모니터에서 텍스트의 가독성을 향상시키는 소프트웨어 기술입니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETCURSORS
0x0057
시스템 커서를 다시 로드합니다. uiParam 매개 변수를 0으로 설정하고 pvParam 매개 변수를 NULL로 설정합니다.
SPI_SETDESKPATTERN
0x0015
Windows가 WIN.INI 파일에서 Pattern= 설정을 읽도록 하여 현재 데스크톱 패턴을 설정합니다.
SPI_SETDESKWALLPAPER
0x0014
참고SPI_SETDESKWALLPAPER 플래그를 사용하면 지정된 파일이 없는 경우와 같이 오류가 발생하지 않는 한 SystemParametersInfoTRUE 를 반환합니다.
 
SPI_SETDROPSHADOW
0x1025
그림자 효과를 사용하거나 사용하지 않도록 설정합니다. pvParamTRUE로 설정하여 그림자 효과를 사용하도록 설정하거나 FALSE를 사용하여 사용하지 않도록 설정합니다. 창 클래스 스타일에도 CS_DROPSHADOW 있어야 합니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETFLATMENU
0x1023
네이티브 사용자 메뉴에 대해 플랫 메뉴 모양을 사용하거나 사용하지 않도록 설정합니다. 플랫 메뉴 모양을 사용하도록 설정하려면 pvParamTRUE 로 설정하고 FALSE 를 설정하여 사용하지 않도록 설정합니다.

사용하도록 설정하면 메뉴 모음은 메뉴 모음 배경에 COLOR_MENUBAR 사용하고, 메뉴 팝업 배경에 COLOR_MENU , 현재 메뉴 선택 영역의 채우기에 COLOR_MENUHILIGHT , 현재 메뉴 선택 영역의 윤곽선에 COLOR_HILIGHT 사용합니다. 사용하지 않도록 설정하면 Windows 2000과 동일한 메트릭 및 색을 사용하여 메뉴가 그려집니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETFONTSMOOTHING
0x004B
글꼴 평활화 기능을 사용하거나 사용하지 않도록 설정합니다. 이 기능은 글꼴 앤티앨리어싱을 사용하여 다른 회색 수준에서 픽셀을 그리면 글꼴 곡선이 더 매끄럽게 표시되도록 합니다.

기능을 사용하도록 설정하려면 uiParam 매개 변수를 TRUE로 설정합니다. 기능을 사용하지 않도록 설정하려면 uiParamFALSE로 설정합니다.

SPI_SETFONTSMOOTHINGCONTRAST
0x200D
ClearType 다듬기에서 사용되는 대비 값을 설정합니다. pvParam 매개 변수는 대비 값입니다. 유효한 대비 값은 1000에서 2200까지입니다. 기본값은 1400입니다.

SPI_SETFONTSMOOTHINGTYPEFE_FONTSMOOTHINGCLEARTYPE 설정해야 합니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETFONTSMOOTHINGORIENTATION
0x2013
글꼴 다듬기 방향을 설정합니다. pvParam 매개 변수는 FE_FONTSMOOTHINGORIENTATIONBGR(파란색-녹색-빨간색) 또는 FE_FONTSMOOTHINGORIENTATIONRGB(빨강-녹색-파란색)입니다.

Windows XP/2000: 이 매개 변수는 WINDOWS XP SP2까지 지원되지 않습니다.

SPI_SETFONTSMOOTHINGTYPE
0x200B
글꼴 다듬기 유형을 설정합니다. pvParam 매개 변수는 표준 앤티앨리어싱을 사용하는 경우 FE_FONTSMOOTHINGSTANDARD 또는 ClearType을 사용하는 경우 FE_FONTSMOOTHINGCLEARTYPE. 기본값은 FE_FONTSMOOTHINGSTANDARD.

SPI_SETFONTSMOOTHING 설정해야 합니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETWORKAREA
0x002F
작업 영역의 크기를 설정합니다. 작업 영역은 시스템 작업 표시줄 또는 애플리케이션 데스크톱 도구 모음에 의해 가려지지 않는 화면의 부분입니다. pvParam 매개 변수는 가상 화면 좌표로 표현되는 새 작업 영역 사각형을 지정하는 RECT 구조체에 대한 포인터입니다. 여러 디스플레이 모니터가 있는 시스템에서 함수는 지정된 사각형을 포함하는 모니터의 작업 영역을 설정합니다.
 

아이콘 매개 변수는 다음과 같습니다.

아이콘 매개 변수 의미
SPI_GETICONMETRICS
0x002D
아이콘과 연결된 메트릭을 검색합니다. pvParam 매개 변수는 정보를 수신하는 ICONMETRICS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ICONMETRICS)설정합니다.
SPI_GETICONTITLELOGFONT
0x001F
현재 아이콘 제목 글꼴에 대한 논리적 글꼴 정보를 검색합니다. uiParam 매개 변수는 LOGFONT 구조체의 크기를 지정하고 pvParam 매개 변수는 채울 LOGFONT 구조를 가리킵니다.
SPI_GETICONTITLEWRAP
0x0019
아이콘 제목 래핑을 사용할지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키거나 그렇지 않으면 FALSE를 가리킵니다.
SPI_ICONHORIZONTALSPACING
0x000D
아이콘 셀의 너비를 픽셀 단위로 설정하거나 검색합니다. 이 사각형은 큰 아이콘 보기로 아이콘을 정렬하는 데 사용됩니다.

이 값을 설정하려면 uiParam 을 새 값으로 설정하고 pvParam을NULL로 설정합니다. 이 값을 SM_CXICON 미만으로 설정할 수 없습니다.

이 값을 검색하려면 pvParam 이 현재 값을 받는 정수 를 가리킵니다.

SPI_ICONVERTICALSPACING
0x0018
아이콘 셀의 높이를 픽셀 단위로 설정하거나 검색합니다.

이 값을 설정하려면 uiParam 을 새 값으로 설정하고 pvParam을NULL로 설정합니다. 이 값을 SM_CYICON 미만으로 설정할 수 없습니다.

이 값을 검색하려면 pvParam 이 현재 값을 받는 정수 를 가리킵니다.

SPI_SETICONMETRICS
0x002E
아이콘과 연결된 메트릭을 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 ICONMETRICS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ICONMETRICS)설정합니다.
SPI_SETICONS
0x0058
시스템 아이콘을 다시 로드합니다. uiParam 매개 변수를 0으로 설정하고 pvParam 매개 변수를 NULL로 설정합니다.
SPI_SETICONTITLELOGFONT
0x0022
아이콘 제목에 사용되는 글꼴을 설정합니다. uiParam 매개 변수는 LOGFONT 구조체의 크기를 지정하고 pvParam 매개 변수는 LOGFONT 구조를 가리킵니다.
SPI_SETICONTITLEWRAP
0x001A
아이콘 제목 래핑을 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고, 해제의 경우 FALSE를 지정합니다.
 

입력 매개 변수는 다음과 같습니다. 여기에는 키보드, 마우스, 터치 패드, 펜, 입력 언어 및 경고 비퍼와 관련된 매개 변수가 포함됩니다.

입력 매개 변수 의미
SPI_GETBEEP
0x0001
경고 비퍼가 켜지는지 여부를 확인합니다.

pvParam 매개 변수는 비퍼가 켜져 있으면 TRUE를 수신하는 BOOL 변수를 가리키고, 비퍼가 꺼져 있으면 FALSE를 가리킵니다.

SPI_GETBLOCKSENDINPUTRESETS
0x1026
SendInput 함수를 호출하여 키보드 또는 마우스 입력을 시뮬레이션하여 애플리케이션이 화면 보호기 타이머를 다시 설정할 수 있는지 여부를 나타내는 BOOL을 검색합니다. pvParam 매개 변수는 시뮬레이션된 입력이 차단될 경우 TRUE를 수신하는 BOOL 변수를 가리킵니다. 그렇지 않으면 FALSE를 가리킵니다.
SPI_GETCONTACTVISUALIZATION
0x2018
현재 연락처 시각화 설정을 검색합니다. pvParam 매개 변수는 설정을 수신하는 ULONG 변수를 가리킵니다. 자세한 내용은 연락처 시각화를 참조하세요.
SPI_GETDEFAULTINPUTLANG
0x0059
시스템 기본 입력 언어에 대한 입력 로캘 식별자를 검색합니다. pvParam 매개 변수는 이 값을 받는 HKL 변수를 가리킵니다. 자세한 내용은 언어, 로캘 및 키보드 레이아웃을 참조하세요.
SPI_GETGESTUREVISUALIZATION
0x201A
현재 제스처 시각화 설정을 검색합니다. pvParam 매개 변수는 설정을 수신하는 ULONG 변수를 가리킵니다. 자세한 내용은 제스처 시각화를 참조하세요.
SPI_GETKEYBOARDCUES
0x100A
메뉴 액세스 키에 항상 밑줄이 표시되는지 여부를 결정합니다. pvParam 매개 변수는 메뉴 액세스 키가 항상 밑줄이 그어지는 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 키보드에서 메뉴를 활성화할 때만 밑줄이 그어지는 경우 FALSE를 가리킵니다.
SPI_GETKEYBOARDDELAY
0x0016
0(약 250ms 지연)부터 3(약 1초 지연)에 이르는 범위의 값인 키보드 반복 지연 설정을 검색합니다. 각 값과 관련된 실제 지연은 하드웨어에 따라 달라질 수 있습니다. pvParam 매개 변수는 설정을 수신하는 정수 변수를 가리킵니다.
SPI_GETKEYBOARDPREF
0x0044
사용자가 마우스 대신 키보드를 사용하는지 여부를 결정하고 애플리케이션에서 숨겨진 키보드 인터페이스를 표시하려고 합니다. pvParam 매개 변수는 사용자가 키보드를 사용하는 경우 TRUE를 수신하는 BOOL 변수를 가리킵니다. 그렇지 않으면 FALSE입니다.
SPI_GETKEYBOARDSPEED
0x000A
0(초당 약 2.5회 반복)부터 31(초당 약 30회 반복) 범위의 값인 키보드 반복 속도 설정을 검색합니다. 실제 반복 속도는 하드웨어에 따라 다르며 선형 규모에서 최대 20%까지 다를 수 있습니다. pvParam 매개 변수는 설정을 수신하는 DWORD 변수를 가리킵니다.
SPI_GETMOUSE
0x0003
두 개의 마우스 임계값과 마우스 가속을 검색합니다. pvParam 매개 변수는 이러한 값을 수신하는 세 개의 정수 배열을 가리킵니다. 자세한 내용은 mouse_event 참조하세요.
SPI_GETMOUSEHOVERHEIGHT
0x0064
TrackMouseEventWM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터를 유지해야 하는 사각형의 높이를 픽셀 단위로 검색합니다. pvParam 매개 변수는 높이를 받는 UINT 변수를 가리킵니다.
SPI_GETMOUSEHOVERTIME
0x0066
WM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터가 TrackMouseEvent 의 가리키기 사각형에 있어야 하는 시간을 밀리 초 단위로 검색합니다. pvParam 매개 변수는 시간을 수신하는 UINT 변수를 가리킵니다.
SPI_GETMOUSEHOVERWIDTH
0x0062
TrackMouseEventWM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터를 유지해야 하는 사각형의 너비를 픽셀 단위로 검색합니다. pvParam 매개 변수는 너비를 받는 UINT 변수를 가리킵니다.
SPI_GETMOUSESPEED
0x0070
현재 마우스 속도를 검색합니다. 마우스 속도는 마우스가 이동하는 거리에 따라 포인터가 이동할 거리를 결정합니다. pvParam 매개 변수는 1(가장 느림)에서 20(가장 빠른) 사이의 값을 받는 정수를 가리킵니다. 값 10이 기본값입니다. 이 값은 마우스 제어판 애플리케이션을 사용하는 최종 사용자 또는 SPI_SETMOUSESPEED 사용하는 애플리케이션에서 설정할 수 있습니다.
SPI_GETMOUSETRAILS
0x005E
마우스 트레일 기능을 사용할 수 있는지 여부를 확인합니다. 이 기능은 커서의 흔적을 간략하게 표시하고 빠르게 지워 마우스 커서 이동의 가시성을 향상시킵니다.

pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다. 값이 0 또는 1이면 기능이 비활성화됩니다. 값이 1보다 크면 기능이 활성화되고 값은 추적에 그려진 커서 수를 나타냅니다. uiParam 매개 변수는 사용되지 않습니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSEWHEELROUTING
0x201C
마우스 휠 입력에 대한 라우팅 설정을 검색합니다. 라우팅 설정은 마우스 휠 입력이 포커스가 있는 앱(포그라운드) 또는 마우스 커서 아래의 앱으로 전송되는지 여부를 결정합니다.

pvParam 매개 변수는 라우팅 옵션을 수신하는 DWORD 변수를 가리킵니다. uiParam 매개 변수는 사용되지 않습니다.

값이 0(MOUSEWHEEL_ROUTING_FOCUS)이면 마우스 휠 입력이 포커스를 사용하여 앱에 전달됩니다. 값이 1(MOUSEWHEEL_ROUTING_HYBRID)이면 마우스 휠 입력이 포커스가 있는 앱(데스크톱 앱) 또는 마우스 포인터(Windows 스토어 앱) 아래의 앱으로 전달됩니다.

Windows 10부터: 값이 2(MOUSEWHEEL_ROUTING_MOUSE_POS)이면 마우스 휠 입력이 마우스 포인터 아래의 앱에 전달됩니다. 이는 새로운 기본값이며 MOUSEWHEEL_ROUTING_HYBRID 설정에서 더 이상 사용할 수 없습니다.

SPI_GETPENVISUALIZATION
0x201E
현재 펜 제스처 시각화 설정을 검색합니다. pvParam 매개 변수는 설정을 수신하는 ULONG 변수를 가리킵니다. 자세한 내용은 펜 시각화를 참조하세요.
SPI_GETSNAPTODEFBUTTON
0x005F
맞춤-기본 단추 기능을 사용할 수 있는지 여부를 결정합니다. 사용하도록 설정하면 마우스 커서가 대화 상자의 기본 단추(예: 확인 또는 적용)로 자동으로 이동합니다. pvParam 매개 변수는 기능이 켜져 있으면 TRUE를 수신하는 BOOL 변수를 가리키고, 해제된 경우 FALSE를 가리킵니다.
SPI_GETSYSTEMLANGUAGEBAR
0x1050
Windows 8부터: 시스템 언어 모음을 사용할지 여부를 결정합니다. pvParam 매개 변수는 언어 모음이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.
SPI_GETTHREADLOCALINPUTSETTINGS
0x104E
Windows 8부터: 활성 입력 설정에 로컬(스레드당, TRUE) 또는 전역(세션, FALSE) 범위가 있는지 여부를 결정합니다. pvParam 매개 변수는 BOOL 변수를 가리킵니다.
SPI_GETTOUCHPADPARAMETERS
0x00AE
Windows 11 버전 24H2부터: 터치 패드와 관련된 사용자 설정 및 시스템 정보를 포함하여 정밀 터치패드에 대한 세부 정보를 검색합니다.

pvParam 매개 변수는 TOUCHPAD_PARAMETERS 구조를 가리킵니다.

uiParam 매개 변수는 구조체의 크기를 지정해야 합니다.

TOUCHPAD_PARAMETERS 구조체의 versionNumber 필드 값은 사용 중인 구조체 버전에 적합한 값으로 설정해야 합니다.

SPI_GETWHEELSCROLLCHARS
0x006C
가로 마우스 휠을 이동할 때 스크롤할 문자 수를 검색합니다. pvParam 매개 변수는 줄 수를 받는 UINT 변수를 가리킵니다. 기본값은 3입니다.
SPI_GETWHEELSCROLLLINES
0x0068
세로 마우스 휠을 이동할 때 스크롤할 줄 수를 검색합니다. pvParam 매개 변수는 줄 수를 받는 UINT 변수를 가리킵니다. 기본값은 3입니다.
SPI_SETBEEP
0x0002
경고 비퍼를 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다.
SPI_SETBLOCKSENDINPUTRESETS
0x1027
애플리케이션이 SendInput 함수를 호출하여 키보드 또는 마우스 입력을 시뮬레이션하여 화면 보호기 타이머를 다시 설정할 수 있는지 여부를 결정합니다. uiParam 매개 변수는 시뮬레이트된 입력에 의해 화면 보호기가 비활성화되지 않는 경우 TRUE를 지정하고, 시뮬레이트된 입력에 의해 화면 보호기가 비활성화될 경우 FALSE를 지정합니다.
SPI_SETCONTACTVISUALIZATION
0x2019
현재 연락처 시각화 설정을 설정합니다. pvParam 매개 변수는 설정을 식별하는 ULONG 변수를 가리킵니다. 자세한 내용은 연락처 시각화를 참조하세요.
참고 연락처 시각화를 사용하지 않도록 설정하면 제스처 시각화를 사용하도록 설정할 수 없습니다.
 
SPI_SETDEFAULTINPUTLANG
0x005A
시스템 셸 및 애플리케이션의 기본 입력 언어를 설정합니다. 지정된 언어는 현재 시스템 문자 집합을 사용하여 표시할 수 있어야 합니다. pvParam 매개 변수는 기본 언어에 대한 입력 로캘 식별자가 포함된 HKL 변수를 가리킵니다. 자세한 내용은 언어, 로캘 및 키보드 레이아웃을 참조하세요.
SPI_SETDOUBLECLICKTIME
0x0020
마우스의 두 번 클릭 시간을 uiParam 매개 변수 값으로 설정합니다. uiParam 값이 5000밀리초보다 큰 경우 시스템은 두 번 클릭 시간을 5000밀리초로 설정합니다.

두 번 클릭 시간은 두 번 클릭의 첫 번째와 두 번째 클릭 사이에 발생할 수 있는 최대 시간(밀리초)입니다. SetDoubleClickTime 함수를 호출하여 두 번 클릭 시간을 설정할 수도 있습니다. 현재 두 번 클릭 시간을 얻으려면 GetDoubleClickTime 함수를 호출합니다.

SPI_SETDOUBLECLKHEIGHT
0x001E
두 번 클릭 사각형의 높이를 uiParam 매개 변수 값으로 설정합니다.

두 번 클릭 사각형은 두 번 클릭으로 등록하려면 두 번 클릭의 두 번째 클릭이 있어야 하는 사각형입니다.

두 번 클릭 사각형의 높이를 검색하려면 SM_CYDOUBLECLK 플래그를 사용하여 GetSystemMetrics를 호출합니다.

SPI_SETDOUBLECLKWIDTH
0x001D
두 번 클릭 사각형의 너비를 uiParam 매개 변수 값으로 설정합니다.

두 번 클릭 사각형은 두 번 클릭으로 등록하려면 두 번 클릭의 두 번째 클릭이 있어야 하는 사각형입니다.

두 번 클릭 사각형의 너비를 검색하려면 SM_CXDOUBLECLK 플래그를 사용하여 GetSystemMetrics를 호출합니다.

SPI_SETGESTUREVISUALIZATION
0x201B
현재 제스처 시각화 설정을 설정합니다. pvParam 매개 변수는 설정을 식별하는 ULONG 변수를 가리킵니다. 자세한 내용은 제스처 시각화를 참조하세요.
참고 연락처 시각화를 사용하지 않도록 설정하면 제스처 시각화를 사용하도록 설정할 수 없습니다.
 
SPI_SETKEYBOARDCUES
0x100B
메뉴 액세스 키 문자의 밑줄을 설정합니다. pvParam 매개 변수는 BOOL 변수입니다. 메뉴 액세스 키에 항상 밑줄을 표시하려면 pvParamTRUE 로 설정하고, 키보드에서 메뉴가 활성화된 경우에만 FALSE 를 메뉴 액세스 키에 밑줄로 설정합니다.
SPI_SETKEYBOARDDELAY
0x0017
키보드 반복 지연 설정을 설정합니다. uiParam 매개 변수는 0, 1, 2 또는 3을 지정해야 합니다. 여기서 0은 가장 짧은 지연을 약 250ms로 설정하고 3은 가장 긴 지연(약 1초)을 설정합니다. 각 값과 관련된 실제 지연은 하드웨어에 따라 달라질 수 있습니다.
SPI_SETKEYBOARDPREF
0x0045
키보드 기본 설정을 지정합니다. uiParam 매개 변수는 사용자가 마우스 대신 키보드를 사용하고 애플리케이션이 숨겨질 키보드 인터페이스를 표시하도록 하려는 경우 TRUE를 지정합니다. 그렇지 않으면 uiParamFALSE입니다.
SPI_SETKEYBOARDSPEED
0x000B
키보드 반복 속도 설정을 설정합니다. uiParam 매개 변수는 0(초당 약 2.5회 반복)에서 31(초당 약 30회 반복) 범위의 값을 지정해야 합니다. 실제 반복 속도는 하드웨어에 따라 달라지며 선형 규모에서 최대 20%까지 달라질 수 있습니다. uiParam이 31보다 크면 매개 변수가 31로 설정됩니다.
SPI_SETLANGTOGGLE
0x005B
입력 언어 간에 전환하기 위한 핫 키 집합을 설정합니다. uiParampvParam 매개 변수는 사용되지 않습니다. 값은 레지스트리를 다시 읽어 키보드 속성 시트의 바로 가기 키를 설정합니다. 이 플래그를 사용하려면 먼저 레지스트리를 설정해야 합니다. 레지스트리의 경로가 HKEY_CURRENT_USER\키보드 레이아웃\토글입니다.

. 유효한 값은 "1" = ALT+Shift, "2" = Ctrl+Shift 및 "3" = none입니다.
SPI_SETMOUSE
0x0004
두 개의 마우스 임계값과 마우스 가속을 설정합니다. pvParam 매개 변수는 이러한 값을 지정하는 세 개의 정수 배열을 가리킵니다. 자세한 내용은 mouse_event 참조하세요.
SPI_SETMOUSEBUTTONSWAP
0x0021
마우스 왼쪽 및 오른쪽 단추의 의미를 바꾸거나 복원합니다. uiParam 매개 변수는 단추의 의미를 교환하려면 TRUE를 지정하고 원래 의미를 복원하려면 FALSE를 지정합니다.

현재 설정을 검색하려면 SM_SWAPBUTTON 플래그를 사용하여 GetSystemMetrics를 호출합니다.

SPI_SETMOUSEHOVERHEIGHT
0x0065
WM_MOUSEHOVER 메시지를 생성하기 위해 TrackMouseEvent에 대해 마우스 포인터를 유지해야 하는 사각형의 높이를 픽셀 단위로 설정합니다. uiParam 매개 변수를 새 높이로 설정합니다.
SPI_SETMOUSEHOVERTIME
0x0067
WM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터가 TrackMouseEvent의 가리키기 사각형에 있어야 하는 시간을 밀리초 단위로 설정합니다. TrackMouseEvent 호출에서 dwHoverTime 매개 변수에 HOVER_DEFAULT 전달하는 경우에만 사용됩니다. uiParam 매개 변수를 새 시간으로 설정합니다.

지정된 시간은 USER_TIMER_MAXIMUM USER_TIMER_MINIMUM 사이여야 합니다. uiParamUSER_TIMER_MINIMUM 미만이면 함수는 USER_TIMER_MINIMUM 사용합니다. uiParamUSER_TIMER_MAXIMUM보다 크면 함수가 USER_TIMER_MAXIMUM.

Windows Server 2003 및 Windows XP: 운영 체제는 WINDOWS Server 2003 SP1 및 Windows XP SP2가 있는 Windows Server 2003까지 USER_TIMER_MAXIMUM 및 USER_TIMER_MINIMUM 사용을 적용하지 않습니다.

SPI_SETMOUSEHOVERWIDTH
0x0063
WM_MOUSEHOVER 메시지를 생성하기 위해 TrackMouseEvent에 대해 마우스 포인터를 유지해야 하는 사각형의 너비를 픽셀 단위로 설정합니다. uiParam 매개 변수를 새 너비로 설정합니다.
SPI_SETMOUSESPEED
0x0071
현재 마우스 속도를 설정합니다. pvParam 매개 변수는 1(가장 느림)에서 20(가장 빠른) 사이의 정수입니다. 값 10이 기본값입니다. 이 값은 일반적으로 마우스 제어판 애플리케이션을 사용하여 설정됩니다.
SPI_SETMOUSETRAILS
0x005D
마우스 추적 기능을 사용하거나 사용하지 않도록 설정하여 커서의 흔적을 간략하게 표시하고 빠르게 지워 마우스 커서 이동의 가시성을 향상시킵니다.

기능을 사용하지 않도록 설정하려면 uiParam 매개 변수를 0 또는 1로 설정합니다. 이 기능을 사용하도록 설정하려면 uiParam 을 1보다 큰 값으로 설정하여 추적에 그려진 커서 수를 나타냅니다.

Windows 2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSEWHEELROUTING
0x201D
마우스 휠 입력에 대한 라우팅 설정을 설정합니다. 라우팅 설정은 마우스 휠 입력이 포커스가 있는 앱(포그라운드) 또는 마우스 커서 아래의 앱으로 전송되는지 여부를 결정합니다.

pvParam 매개 변수는 라우팅 옵션을 수신하는 DWORD 변수를 가리킵니다. uiParam 매개 변수를 0으로 설정합니다.

값이 0(MOUSEWHEEL_ROUTING_FOCUS)이면 마우스 휠 입력이 포커스를 사용하여 앱에 전달됩니다. 값이 1(MOUSEWHEEL_ROUTING_HYBRID)이면 마우스 휠 입력이 포커스가 있는 앱(데스크톱 앱) 또는 마우스 포인터(Windows 스토어 앱) 아래의 앱으로 전달됩니다.

Windows 10부터: 값이 2(MOUSEWHEEL_ROUTING_MOUSE_POS)이면 마우스 휠 입력이 마우스 포인터 아래의 앱에 전달됩니다. 이는 새로운 기본값이며 MOUSEWHEEL_ROUTING_HYBRID 설정에서 더 이상 사용할 수 없습니다.

SPI_SETPENVISUALIZATION
0x201F
현재 펜 제스처 시각화 설정을 설정합니다. pvParam 매개 변수는 설정을 식별하는 ULONG 변수를 가리킵니다. 자세한 내용은 펜 시각화를 참조하세요.
SPI_SETSNAPTODEFBUTTON
0x0060
snap-to-default-button 기능을 사용하거나 사용하지 않도록 설정합니다. 사용하도록 설정하면 마우스 커서가 대화 상자의 기본 단추(예: 확인 또는 적용)로 자동으로 이동합니다. uiParam 매개 변수를 TRUE로 설정하여 기능을 사용하도록 설정하거나 FALSE를 설정하여 사용하지 않도록 설정합니다. 대화 상자 관리자가 마우스 커서를 배치할 수 있도록 애플리케이션은 대화 상자를 표시할 때 ShowWindow 함수를 사용해야 합니다.
SPI_SETSYSTEMLANGUAGEBAR
0x1051
Windows 8부터: 레거시 언어 모음 기능을 켜거나 끕니다. pvParam 매개 변수는 BOOL 변수에 대한 포인터입니다. pvParamTRUE로 설정하여 레거시 언어 모음을 사용하도록 설정하거나 FALSE를 사용하여 사용하지 않도록 설정합니다. 플래그는 Windows 8에서 지원됩니다. 여기서 레거시 언어 모음은 입력 전환기로 대체되므로 기본적으로 꺼져 있습니다. 레거시 언어 모음을 켜는 것은 호환성을 위해 제공되며 입력 전환기에서 영향을 주지 않습니다.
SPI_SETTHREADLOCALINPUTSETTINGS
0x104F
Windows 8부터: 활성 입력 설정에 로컬(스레드당, TRUE) 또는 전역(세션, FALSE) 범위가 있는지 여부를 결정합니다. pvParam 매개 변수는 PVOID에서 캐스팅된 BOOL 변수여야 합니다.
SPI_SETTOUCHPADPARAMETERS
0x00AF
Windows 11 버전 24H2부터: 터치 패드와 관련된 사용자 설정 및 시스템 정보를 포함하여 정밀 터치패드에 대한 세부 정보를 설정합니다.

pvParam 매개 변수는 TOUCHPAD_PARAMETERS 구조를 가리킵니다.

uiParam 매개 변수는 구조체의 크기를 지정해야 합니다.

TOUCHPAD_PARAMETERS 구조체의 versionNumber 필드 값은 사용 중인 구조체 버전에 적합한 값으로 설정해야 합니다.

SPI_SETWHEELSCROLLCHARS
0x006D
가로 마우스 휠을 이동할 때 스크롤할 문자 수를 설정합니다. 문자 수는 uiParam 매개 변수에서 설정됩니다.
SPI_SETWHEELSCROLLLINES
0x0069
세로 마우스 휠을 이동할 때 스크롤할 줄 수를 설정합니다. 줄 수는 uiParam 매개 변수에서 설정됩니다.

줄 수는 한정자 키를 사용하지 않고 마우스 휠을 압연할 때 스크롤할 제안된 줄 수입니다. 숫자가 0이면 스크롤이 발생하지 않습니다. 스크롤할 줄 수가 볼 수 있는 줄 수보다 크고 특히 WHEEL_PAGESCROLL(#definedUINT_MAX)인 경우 스크롤 작업은 스크롤 막대의 페이지 아래쪽 또는 페이지 위로 영역을 한 번 클릭하는 것으로 해석되어야 합니다.

 

메뉴 매개 변수는 다음과 같습니다.

메뉴 매개 변수 의미
SPI_GETMENUDROPALIGNMENT
0x001B
해당 메뉴 모음 항목을 기준으로 팝업 메뉴가 왼쪽 맞춤 또는 오른쪽 맞춤인지 여부를 결정합니다. pvParam 매개 변수는 오른쪽 맞춤이면 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다.
SPI_GETMENUFADE
0x1012
메뉴 페이드 애니메이션을 사용할지 여부를 결정합니다. pvParam 매개 변수는 페이드 애니메이션을 사용할 때 TRUE를 수신하는 BOOL변수를 가리킨 다음 FALSE를 지정해야 합니다. 페이드 애니메이션을 사용하지 않도록 설정하면 메뉴에서 슬라이드 애니메이션을 사용합니다. SPI_SETMENUANIMATION 플래그를 사용하여 수행할 수 있는 메뉴 애니메이션을 사용하지 않는 한 이 플래그는 무시됩니다. 자세한 내용은 AnimateWindow를 참조하세요.
SPI_GETMENUSHOWDELAY
0x006A
마우스 커서가 하위 메뉴 항목 위에 있을 때 바로 가기 메뉴를 표시하기 전에 시스템에서 대기하는 시간(밀리초)을 검색합니다. pvParam 매개 변수는 지연 시간을 수신하는 DWORD 변수를 가리킵니다.
SPI_SETMENUDROPALIGNMENT
0x001C
팝업 메뉴의 맞춤 값을 설정합니다. uiParam 매개 변수는 오른쪽 맞춤의 경우 TRUE, 왼쪽 맞춤의 경우 FALSE를 지정합니다.
SPI_SETMENUFADE
0x1013
메뉴 페이드 애니메이션을 사용하거나 사용하지 않도록 설정합니다. 메뉴 페이드 효과를 사용하도록 설정하려면 pvParamTRUE 로 설정하고 FALSE 를 설정하여 사용하지 않도록 설정합니다. 페이드 애니메이션을 사용하지 않도록 설정하면 메뉴에서 슬라이드 애니메이션을 사용합니다. 그는 시스템의 색 깊이가 256 색보다 큰 경우에만 메뉴 페이드 효과를 사용할 수 있습니다. SPI_MENUANIMATION 설정되지 않으면 이 플래그는 무시됩니다. 자세한 내용은 AnimateWindow를 참조하세요.
SPI_SETMENUSHOWDELAY
0x006B
마우스 커서가 하위 메뉴 항목 위에 있을 때 시스템이 바로 가기 메뉴를 표시하기 전에 대기하는 시간(밀리초)으로 uiParam 을 설정합니다.
 

다음은 전원 매개 변수입니다.

Windows Server 2008 및 Windows Vista부터 이러한 전원 매개 변수는 지원되지 않습니다. 대신 현재 디스플레이 전원 상태를 확인하려면 애플리케이션이 GUID_MONITOR_POWER_STATE 알림을 등록해야 합니다. 현재 디스플레이 전원 가동 중지 시간 초과를 확인하려면 애플리케이션이 GUID_VIDEO_POWERDOWN_TIMEOUT 전원 설정 변경에 대한 알림을 등록해야 합니다. 자세한 내용은 전원 이벤트 등록을 참조하세요.

Windows Server 2003 및 Windows XP/2000: 현재 디스플레이 전원 상태를 확인하려면 다음 전원 매개 변수를 사용합니다.

전원 매개 변수 의미
SPI_GETLOWPOWERACTIVE
0x0053
이 매개 변수는 지원되지 않습니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 저전력 단계를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_GETLOWPOWERTIMEOUT
0x004F
이 매개 변수는 지원되지 않습니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 저전력 단계에 대한 제한 시간 값을 검색합니다. pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_GETPOWEROFFACTIVE
0x0054
이 매개 변수는 지원되지 않습니다. 화면 저장의 전원 끄기 단계를 사용하도록 설정하면 GUID_VIDEO_POWERDOWN_TIMEOUT 전원 설정이 0보다 큽니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 전원 끄기 단계를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_GETPOWEROFFTIMEOUT
0x0050
이 매개 변수는 지원되지 않습니다. 대신 GUID_VIDEO_POWERDOWN_TIMEOUT 전원 설정을 확인합니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 전원 끄기 단계에 대한 제한 시간 값을 검색합니다. pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_SETLOWPOWERACTIVE
0x0055
이 매개 변수는 지원되지 않습니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 저전력 단계를 활성화하거나 비활성화합니다. 활성화하려면 uiParam을 1로, 비활성화하려면 0으로 설정합니다. pvParam 매개 변수는 NULL이어야 합니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_SETLOWPOWERTIMEOUT
0x0051
이 매개 변수는 지원되지 않습니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 저전력 단계에 대한 제한 시간 값(초)을 설정합니다. uiParam 매개 변수는 새 값을 지정합니다. pvParam 매개 변수는 NULL이어야 합니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_SETPOWEROFFACTIVE
0x0056
이 매개 변수는 지원되지 않습니다. 대신 GUID_VIDEO_POWERDOWN_TIMEOUT 전원 설정을 설정합니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 전원 끄기 단계를 활성화하거나 비활성화합니다. 활성화하려면 uiParam을 1로, 비활성화하려면 0으로 설정합니다. pvParam 매개 변수는 NULL이어야 합니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

SPI_SETPOWEROFFTIMEOUT
0x0052
이 매개 변수는 지원되지 않습니다. 대신 GUID_VIDEO_POWERDOWN_TIMEOUT 전원 설정을 제한 시간 값으로 설정합니다.

Windows Server 2003 및 Windows XP/2000: 화면 저장의 전원 끄기 단계에 대한 제한 시간 값(초)을 설정합니다. uiParam 매개 변수는 새 값을 지정합니다. pvParam 매개 변수는 NULL이어야 합니다. 이 플래그는 32비트 애플리케이션에서만 지원됩니다.

 

다음은 화면 보호기 매개 변수입니다.

화면 보호기 매개 변수 의미
SPI_GETSCREENSAVEACTIVE
0x0010
화면 저장을 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 화면 저장을 사용하도록 설정하면 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.

Windows 7, Windows Server 2008 R2 및 Windows 2000: 화면 저장을 사용하도록 설정하지 않은 경우에도 함수는 TRUE 를 반환합니다.

SPI_GETSCREENSAVERRUNNING
0x0072
호출 프로세스의 창 스테이션에서 화면 보호기가 현재 실행 중인지 여부를 확인합니다. pvParam 매개 변수는 화면 보호기가 현재 실행 중인 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다. 대화형 창 스테이션인 WinSta0만 화면 보호기를 실행할 수 있습니다.
SPI_GETSCREENSAVESECURE
0x0076
Windows 데스크톱을 표시하기 위해 화면 보호기에서 암호가 필요한지 여부를 결정합니다. pvParam 매개 변수는 화면 보호기에서 암호가 필요한 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다. uiParam 매개 변수는 무시됩니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETSCREENSAVETIMEOUT
0x000E
화면 절약 시간 제한 값(초)을 검색합니다. pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다.
SPI_SETSCREENSAVEACTIVE
0x0011
화면 보호기의 상태를 설정합니다. uiParam 매개 변수는 화면 저장을 활성화하기 위해 TRUE를 지정하거나 FALSE를 지정하여 비활성화합니다.

컴퓨터가 절전 모드 또는 시스템 잠금 상태로 전환되면 ERROR_OPERATION_IN_PROGRESS 예외가 발생합니다.

SPI_SETSCREENSAVESECURE
0x0077
화면 보호기에서 사용자가 Windows 데스크톱을 표시하기 위해 암호를 입력해야 하는지 여부를 설정합니다. uiParam 매개 변수는 BOOL 변수입니다. pvParam 매개 변수는 무시됩니다. 암호를 요구하려면 uiParamTRUE 로, 암호가 필요하지 않으면 FALSE 로 설정합니다.

컴퓨터가 절전 모드 또는 시스템 잠금 상태로 전환되면 ERROR_OPERATION_IN_PROGRESS 예외가 발생합니다.

Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETSCREENSAVETIMEOUT
0x000F
화면 절약 시간 제한 값을 uiParam 매개 변수 값으로 설정합니다. 이 값은 화면 보호기가 활성화되기 전에 시스템이 유휴 상태여야 하는 시간(초)입니다.

컴퓨터가 절전 모드 또는 시스템 잠금 상태로 전환되면 ERROR_OPERATION_IN_PROGRESS 예외가 발생합니다.

 

다음은 애플리케이션 및 서비스에 대한 제한 시간 매개 변수입니다.

시간 제한 매개 변수 의미
SPI_GETHUNGAPPTIMEOUT
0x0078
시스템에서 응답하지 않는 것으로 간주하기 전에 메시지를 디스패치하지 않고 스레드가 갈 수 있는 시간(밀리초)을 검색합니다. pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETWAITTOKILLTIMEOUT
0x007A
시스템이 종료 요청에 응답하지 않는 애플리케이션을 종료하기 전에 대기하는 시간(밀리초)을 검색합니다. pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETWAITTOKILLSERVICETIMEOUT
0x007C
종료 요청에 응답하지 않는 서비스를 종료하기 전에 서비스 제어 관리자가 대기하는 시간(밀리초)을 검색합니다. pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETHUNGAPPTIMEOUT
0x0079
중단된 애플리케이션 제한 시간을 uiParam 매개 변수 값으로 설정합니다. 이 값은 시스템에서 응답하지 않는 것으로 간주하기 전에 메시지를 디스패치하지 않고 스레드가 갈 수 있는 시간(밀리초)입니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETWAITTOKILLTIMEOUT
0x007B
애플리케이션 종료 요청 제한 시간을 uiParam 매개 변수 값으로 설정합니다. 이 값은 시스템이 종료 요청에 응답하지 않는 애플리케이션을 종료하기 전에 대기하는 시간(밀리초)입니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETWAITTOKILLSERVICETIMEOUT
0x007D
서비스 종료 요청 제한 시간을 uiParam 매개 변수 값으로 설정합니다. 이 값은 시스템이 종료 요청에 응답하지 않는 서비스를 종료하기 전에 대기하는 시간(밀리초)입니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

 

다음은 UI 효과입니다. SPI_SETUIEFFECTS 값은 모든 UI 효과를 한 번에 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 이 테이블에는 UI 효과 값의 전체 목록이 포함되어 있습니다.

UI 효과 매개 변수 의미
SPI_GETCOMBOBOXANIMATION
0x1004
콤보 상자에 대한 슬라이드 열기 효과를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
SPI_GETCURSORSHADOW
0x101A
커서 주위에 그림자가 있는지 여부를 확인합니다. pvParam 매개 변수는 그림자가 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음, 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 이 효과는 시스템에 색 깊이가 256개 이상인 경우에만 나타납니다.
SPI_GETGRADIENTCAPTIONS
0x1008
창 제목 표시줄의 그라데이션 효과를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 그라데이션 효과에 대한 자세한 내용은 GetSysColor 함수를 참조하세요.
SPI_GETHOTTRACKING
0x100E
메뉴 모음의 메뉴 이름과 같은 사용자 인터페이스 요소의 핫 추적을 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.

핫 트랙은 커서가 항목 위로 이동하면 강조 표시되지만 선택되지는 않음을 의미합니다. 이 값을 쿼리하여 애플리케이션의 사용자 인터페이스에서 핫 추적을 사용할지 여부를 결정할 수 있습니다.

SPI_GETLISTBOXSMOOTHSCROLLING
0x1006
목록 상자의 부드러운 스크롤 효과를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
SPI_GETMENUANIMATION
0x1002
메뉴 애니메이션 기능을 사용할 수 있는지 여부를 결정합니다. 메뉴 애니메이션 효과를 사용하려면 이 마스터 스위치가 켜져 있어야 합니다. pvParam 매개 변수는 애니메이션이 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.

애니메이션을 사용하는 경우 SPI_GETMENUFADE 메뉴에서 페이드 애니메이션 또는 슬라이드 애니메이션을 사용하는지 여부를 나타냅니다.

SPI_GETMENUUNDERLINES
0x100A
SPI_GETKEYBOARDCUES 동일합니다.
SPI_GETSELECTIONFADE
0x1014
선택 페이드 효과를 사용할지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.

선택 페이드 효과로 인해 사용자가 선택한 메뉴 항목이 잠시 화면에 남아 있는 동안 메뉴가 해제된 후 사라집니다.

SPI_GETTOOLTIPANIMATION
0x1016
도구 설명 애니메이션을 사용할지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 도구 설명 애니메이션을 사용하는 경우 SPI_GETTOOLTIPFADE 도구 설명이 페이드 애니메이션 또는 슬라이드 애니메이션을 사용하는지 여부를 나타냅니다.
SPI_GETTOOLTIPFADE
0x1018
SPI_SETTOOLTIPANIMATION 사용하도록 설정된 경우 SPI_GETTOOLTIPFADE 도구 설명 애니메이션이 페이드 효과 또는 슬라이드 효과를 사용하는지 여부를 나타냅니다. pvParam 매개 변수는 페이드 애니메이션의 경우 TRUE를 수신하는 BOOL 변수를 가리키고 슬라이드 애니메이션의 경우 FALSE를 가리킵니다. 슬라이드 및 페이드 효과에 대한 자세한 내용은 AnimateWindow를 참조하세요.
SPI_GETUIEFFECTS
0x103E
UI 효과를 사용할지 아니면 사용하지 않도록 설정할지 여부를 결정합니다. pvParam 매개 변수는 모든 UI 효과가 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
SPI_SETCOMBOBOXANIMATION
0x1005
콤보 상자에 대해 슬라이드 열기 효과를 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수를 TRUE로 설정하여 그라데이션 효과를 사용하도록 설정하거나 FALSE를 설정하여 사용하지 않도록 설정합니다.
SPI_SETCURSORSHADOW
0x101B
커서 주위의 그림자를 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수는 BOOL 변수입니다. 그림자를 사용하도록 설정하려면 pvParamTRUE 로 설정하거나 FALSE 를 설정하여 그림자를 사용하지 않도록 설정합니다. 이 효과는 시스템에 색 깊이가 256개 이상인 경우에만 나타납니다.
SPI_SETGRADIENTCAPTIONS
0x1009
창 제목 표시줄의 그라데이션 효과를 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수를 사용하도록 설정하려면 TRUE로, FALSE를 설정하여 사용하지 않도록 설정합니다. 그라데이션 효과는 시스템에 색 깊이가 256개 이상인 경우에만 가능합니다. 그라데이션 효과에 대한 자세한 내용은 GetSysColor 함수를 참조하세요.
SPI_SETHOTTRACKING
0x100F
메뉴 모음의 메뉴 이름과 같은 사용자 인터페이스 요소의 핫 추적을 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수를 사용하도록 설정하려면 TRUE로, FALSE를 설정하여 사용하지 않도록 설정합니다.

핫 트래킹은 커서가 항목 위로 이동하면 강조 표시되지만 선택되지 않음을 의미합니다.

SPI_SETLISTBOXSMOOTHSCROLLING
0x1007
목록 상자에 대해 부드러운 스크롤 효과를 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수를 TRUE로 설정하여 부드러운 스크롤 효과를 사용하도록 설정하거나 FALSE를 설정하여 사용하지 않도록 설정합니다.
SPI_SETMENUANIMATION
0x1003
메뉴 애니메이션을 사용하거나 사용하지 않도록 설정합니다. 메뉴 애니메이션이 발생하려면 이 마스터 스위치가 켜져 있어야 합니다. pvParam 매개 변수는 BOOL 변수입니다. 애니메이션을 사용하도록 설정하려면 pvParamTRUE로 설정하고 FALSE를 설정하여 애니메이션을 사용하지 않도록 설정합니다.

애니메이션을 사용하는 경우 SPI_GETMENUFADE 메뉴에서 페이드 애니메이션 또는 슬라이드 애니메이션을 사용하는지 여부를 나타냅니다.

SPI_SETMENUUNDERLINES
0x100B
SPI_SETKEYBOARDCUES 동일합니다.
SPI_SETSELECTIONFADE
0x1015
선택 페이드 효과를 사용하도록 설정하려면 pvParamTRUE 로 설정하고 FALSE 를 설정하여 사용하지 않도록 설정합니다.

선택 페이드 효과로 인해 사용자가 선택한 메뉴 항목이 잠시 화면에 남아 있는 동안 메뉴가 해제된 후 사라집니다. 시스템에 색 깊이가 256개 이상인 경우에만 선택 페이드 효과를 사용할 수 있습니다.

SPI_SETTOOLTIPANIMATION
0x1017
pvParamTRUE로 설정하여 도구 설명 애니메이션을 사용하도록 설정하거나 FALSE를 사용하여 사용하지 않도록 설정합니다. 사용하도록 설정된 경우 SPI_SETTOOLTIPFADE 사용하여 페이드 또는 슬라이드 애니메이션을 지정할 수 있습니다.
SPI_SETTOOLTIPFADE
0x1019
SPI_SETTOOLTIPANIMATION 플래그를 사용하는 경우 SPI_SETTOOLTIPFADE 사용하여 도구 설명 애니메이션이 페이드 효과 또는 슬라이드 효과를 사용하는지 여부를 나타냅니다. 페이드 애니메이션의 경우 pvParamTRUE 로, 슬라이드 애니메이션의 경우 FALSE 로 설정합니다. 도구 설명 페이드 효과는 시스템에 색 깊이가 256개 이상인 경우에만 가능합니다. 슬라이드 및 페이드 효과에 대한 자세한 내용은 AnimateWindow 함수를 참조하세요.
SPI_SETUIEFFECTS
0x103F
UI 효과를 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수를 TRUE로 설정하여 모든 UI 효과를 사용하도록 설정하거나 FALSE를 사용하여 모든 UI 효과를 사용하지 않도록 설정합니다.
 

다음은 창 매개 변수입니다.

Window 매개 변수 의미
SPI_GETACTIVEWINDOWTRACKING
0x1000
활성 창 추적(마우스가 켜진 창 활성화)이 켜지거나 꺼져 있는지 여부를 결정합니다. pvParam 매개 변수는 ON에 대해 TRUE를 수신하는 BOOL 변수를 가리키거나 해제할 경우 FALSE를 가리킵니다.
SPI_GETACTIVEWNDTRKZORDER
0x100C
활성 창 추적을 통해 활성화된 창을 맨 위로 가져올지 여부를 결정합니다. pvParam 매개 변수는 ON에 대해 TRUE를 수신하는 BOOL 변수를 가리키거나 해제할 경우 FALSE를 가리킵니다.
SPI_GETACTIVEWNDTRKTIMEOUT
0x2002
활성 창 추적 지연(밀리초)을 검색합니다. pvParam 매개 변수는 시간을 수신하는 DWORD 변수를 가리킵니다.
SPI_GETANIMATION
0x0048
사용자 작업과 연결된 애니메이션 효과를 검색합니다. pvParam 매개 변수는 정보를 수신하는 ANIMATIONINFO 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ANIMATIONINFO)설정합니다.
SPI_GETBORDER
0x0005
창 크기 조정 테두리의 너비를 결정하는 테두리 승수 인수를 검색합니다. pvParam 매개 변수는 이 값을 받는 정수 변수를 가리킵니다.
SPI_GETCARETWIDTH
0x2006
편집 컨트롤의 캐리트 너비를 픽셀 단위로 검색합니다. pvParam 매개 변수는 이 값을 수신하는 DWORD 변수를 가리킵니다.
SPI_GETDOCKMOVING
0x0090
창이 모니터 또는 모니터 배열의 위쪽, 왼쪽 또는 오른쪽 가장자리로 이동할 때 도킹되는지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키거나 그렇지 않으면 FALSE를 가리킵니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETDRAGFROMMAXIMIZE
0x008C
캡션 표시줄을 끌 때 최대화된 창이 복원되는지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키거나 그렇지 않으면 FALSE를 가리킵니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETDRAGFULLWINDOWS
0x0026
전체 창의 끌기를 사용할지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키거나 그렇지 않으면 FALSE를 가리킵니다.
SPI_GETFOREGROUNDFLASHCOUNT
0x2004
전경 스위치 요청을 거부할 때 SetForegroundWindow 가 작업 표시줄 단추를 깜박이는 횟수를 검색합니다. pvParam 매개 변수는 값을 받는 DWORD 변수를 가리킵니다.
SPI_GETFOREGROUNDLOCKTIMEOUT
0x2000
시스템에서 애플리케이션이 포그라운드로 강제 진입하는 것을 허용하지 않는 사용자 입력 다음 시간(밀리초)을 검색합니다. pvParam 매개 변수는 시간을 수신하는 DWORD 변수를 가리킵니다.
SPI_GETMINIMIZEDMETRICS
0x002B
최소화된 창과 연결된 메트릭을 검색합니다. pvParam 매개 변수는 정보를 수신하는 MINIMIZEDMETRICS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(MINIMIZEDMETRICS)설정합니다.
SPI_GETMOUSEDOCKTHRESHOLD
0x007E
마우스를 사용하여 창을 모니터 또는 모니터 배열의 가장자리로 끌어 도킹 동작이 트리거되는 임계값을 픽셀 단위로 검색합니다. 기본 임계값은 1입니다. pvParam 매개 변수는 값을 받는 DWORD 변수를 가리킵니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSEDRAGOUTTHRESHOLD
0x0084
마우스를 사용하여 모니터 가장자리 또는 모니터 배열의 가장자리에서 가운데로 창을 끌어 도킹 해제 동작이 트리거되는 임계값을 픽셀 단위로 검색합니다. 기본 임계값은 20입니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETMOUSESIDEMOVETHRESHOLD
0x0088
마우스로 끌 때 세로로 최대화된 창이 복원되는 모니터 또는 모니터 배열의 맨 위에서 픽셀 단위로 임계값을 검색합니다. 기본 임계값은 50입니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETNONCLIENTMETRICS
0x0029
최소화되지 않은 창의 비클라이언트 영역과 관련된 메트릭을 검색합니다. pvParam 매개 변수는 정보를 수신하는 NONCLIENTMETRICS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(NONCLIENTMETRICS)설정합니다.

Windows Server 2003 및 Windows XP/2000: NONCLIENTMETRICS에 대한 설명을 참조하세요.

SPI_GETPENDOCKTHRESHOLD
0x0080
펜을 사용하여 창을 모니터 또는 모니터 배열의 가장자리로 끌어 도킹 동작이 트리거되는 임계값을 픽셀 단위로 검색합니다. 기본값은 30입니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETPENDRAGOUTTHRESHOLD
0x0086
펜을 사용하여 모니터 또는 모니터 배열의 가장자리에서 가운데로 창을 끌어서 도킹 해제 동작이 트리거되는 임계값을 픽셀 단위로 검색합니다. 기본 임계값은 30입니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETPENSIDEMOVETHRESHOLD
0x008A
마우스로 끌 때 세로로 최대화된 창이 복원되는 모니터 또는 모니터 배열의 위쪽에서 임계값을 픽셀 단위로 검색합니다. 기본 임계값은 50입니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETSHOWIMEUI
0x006E
IME 상태 창이 표시되는지 여부를 결정합니다(사용자 단위로). pvParam 매개 변수는 상태 창이 표시되면 TRUE를 수신하는 BOOL 변수를 가리키고, 그렇지 않으면 FALSE를 가리킵니다.
SPI_GETSNAPSIZING
0x008E
창이 모니터 또는 모니터 배열의 위쪽 또는 아래쪽에 크기가 조정될 때 세로로 최대화되는지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다.

SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_GETWINARRANGING
0x0082
창 배열을 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다.

창 배열은 창이 끌거나 크기가 조정될 때 창의 기본 동작을 간소화하여 최상위 창을 이동하고 크기를 조정하는 데 필요한 마우스, 펜 또는 터치 조작의 수를 줄입니다.

다음 매개 변수는 개별 창 정렬 설정을 검색합니다.

SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.
SPI_SETACTIVEWINDOWTRACKING
0x1001
활성 창 추적(마우스가 켜진 창 활성화)을 설정하거나 해제합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.
SPI_SETACTIVEWNDTRKZORDER
0x100D
활성 창 추적을 통해 활성화된 창을 맨 위로 가져올지 여부를 결정합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.
SPI_SETACTIVEWNDTRKTIMEOUT
0x2003
활성 창 추적 지연을 설정합니다. pvParam을 마우스 포인터 아래의 창을 활성화하기 전에 지연할 시간(밀리초)으로 설정합니다.
SPI_SETANIMATION
0x0049
사용자 작업과 연결된 애니메이션 효과를 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 ANIMATIONINFO 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ANIMATIONINFO)설정합니다.
SPI_SETBORDER
0x0006
창 크기 조정 테두리의 너비를 결정하는 테두리 승수 인수를 설정합니다. uiParam 매개 변수는 새 값을 지정합니다.
SPI_SETCARETWIDTH
0x2007
편집 컨트롤의 캐리트 너비를 설정합니다. pvParam을 원하는 너비(픽셀)로 설정합니다. 기본값과 최소값은 1입니다.
SPI_SETDOCKMOVING
0x0091
모니터 또는 모니터 배열의 위쪽, 왼쪽 또는 오른쪽 도킹 대상으로 이동할 때 창이 도킹되는지 여부를 설정합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETDRAGFROMMAXIMIZE
0x008D
캡션 표시줄을 끌 때 최대화된 창이 복원되는지 여부를 설정합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETDRAGFULLWINDOWS
0x0025
전체 창의 끌기를 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다.
SPI_SETDRAGHEIGHT
0x004D
끌기 작업의 시작을 감지하는 데 사용되는 사각형의 높이를 픽셀 단위로 설정합니다. uiParam을 새 값으로 설정합니다. 끌기 높이를 검색하려면 SM_CYDRAG 플래그를 사용하여 GetSystemMetrics를 호출합니다.
SPI_SETDRAGWIDTH
0x004C
끌기 작업의 시작을 감지하는 데 사용되는 사각형의 너비를 픽셀 단위로 설정합니다. uiParam을 새 값으로 설정합니다. 끌기 너비를 검색하려면 SM_CXDRAG 플래그를 사용하여 GetSystemMetrics를 호출합니다.
SPI_SETFOREGROUNDFLASHCOUNT
0x2005
전경 스위치 요청을 거부할 때 SetForegroundWindow 가 작업 표시줄 단추를 플래시하는 횟수를 설정합니다. pvParam을 플래시할 횟수로 설정합니다.
SPI_SETFOREGROUNDLOCKTIMEOUT
0x2001
시스템에서 애플리케이션이 포그라운드로 강제 적용하는 것을 허용하지 않는 사용자 입력 다음 시간(밀리초)을 설정합니다. pvParam을 새 시간 제한 값으로 설정합니다.

호출 스레드는 포그라운드 창을 변경할 수 있어야 합니다. 그렇지 않으면 호출이 실패합니다.

SPI_SETMINIMIZEDMETRICS
0x002C
최소화된 창과 연결된 메트릭을 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 MINIMIZEDMETRICS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(MINIMIZEDMETRICS)설정합니다.
SPI_SETMOUSEDOCKTHRESHOLD
0x007F
마우스를 사용하여 창을 모니터 또는 모니터 배열의 가장자리로 끌어 도킹 동작이 트리거되는 임계값을 픽셀 단위로 설정합니다. 기본 임계값은 1입니다. pvParam 매개 변수는 새 값이 포함된 DWORD 변수를 가리킵니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSEDRAGOUTTHRESHOLD
0x0085
마우스를 사용하여 모니터 또는 모니터 배열의 가장자리에서 가운데로 창을 끌어서 도킹 해제 동작이 트리거되는 임계값을 픽셀 단위로 설정합니다. 기본 임계값은 20입니다. pvParam 매개 변수는 새 값이 포함된 DWORD 변수를 가리킵니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETMOUSESIDEMOVETHRESHOLD
0x0089
마우스로 끌 때 세로로 최대화된 창이 복원되는 모니터 위쪽에서 임계값을 픽셀 단위로 설정합니다. 기본 임계값은 50입니다. pvParam 매개 변수는 새 값이 포함된 DWORD 변수를 가리킵니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETNONCLIENTMETRICS
0x002A
축소되지 않은 창의 비클라이언트 영역과 연결된 메트릭을 설정합니다. pvParam 매개 변수는 새 매개 변수를 포함하는 NONCLIENTMETRICS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(NONCLIENTMETRICS)설정합니다. 또한 LOGFONT 구조체의 lfHeight 멤버는 음수 값이어야 합니다.
SPI_SETPENDOCKTHRESHOLD
0x0081
펜을 사용하여 창을 모니터 또는 모니터 배열의 가장자리로 끌어 도킹 동작이 트리거되는 임계값을 픽셀 단위로 설정합니다. 기본 임계값은 30입니다. pvParam 매개 변수는 새 값이 포함된 DWORD 변수를 가리킵니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETPENDRAGOUTTHRESHOLD
0x0087
펜을 사용하여 모니터 또는 모니터 배열의 가장자리에서 가운데로 창을 끌어서 도킹 해제 동작이 트리거되는 임계값을 픽셀 단위로 설정합니다. 기본 임계값은 30입니다. pvParam 매개 변수는 새 값이 포함된 DWORD 변수를 가리킵니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETPENSIDEMOVETHRESHOLD
0x008B
펜으로 끌 때 세로로 최대화된 창이 복원되는 모니터 위쪽에서 임계값을 픽셀 단위로 설정합니다. 기본 임계값은 50입니다. pvParam 매개 변수는 새 값이 포함된 DWORD 변수를 가리킵니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETSHOWIMEUI
0x006F
IME 상태 창이 사용자 단위로 표시되는지 여부를 설정합니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다.
SPI_SETSNAPSIZING
0x008F
창이 모니터의 위쪽 또는 아래쪽으로 크기가 조정될 때 세로로 최대화되는지 여부를 설정합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.

동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다.

Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

SPI_SETWINARRANGING
0x0083
창 배열을 사용할지 여부를 설정합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.

창 배열은 창이 끌거나 크기가 조정될 때 창의 기본 동작을 간소화하여 최상위 창을 이동하고 크기를 조정하는 데 필요한 마우스, 펜 또는 터치 조작의 수를 줄입니다.

다음 매개 변수는 개별 창 정렬 설정을 설정합니다.

SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다.

[in] uiParam

형식: UINT

사용량 및 형식이 쿼리 또는 설정되는 시스템 매개 변수에 따라 달라지는 매개 변수입니다. 시스템 전체 매개 변수에 대한 자세한 내용은 uiAction 매개 변수를 참조하세요. 달리 표시되지 않으면 이 매개 변수에 대해 0을 지정해야 합니다.

[in, out] pvParam

형식: PVOID

사용량 및 형식이 쿼리 또는 설정되는 시스템 매개 변수에 따라 달라지는 매개 변수입니다. 시스템 전체 매개 변수에 대한 자세한 내용은 uiAction 매개 변수를 참조하세요. 달리 표시되지 않으면 이 매개 변수에 대해 NULL 을 지정해야 합니다. PVOID 데이터 형식에 대한 자세한 내용은 Windows 데이터 형식을 참조하세요.

[in] fWinIni

형식: UINT

시스템 매개 변수를 설정하는 경우 는 사용자 프로필을 업데이트할지 여부를 지정하고, 업데이트할 경우 WM_SETTINGCHANGE 메시지를 모든 최상위 창으로 브로드캐스트하여 변경 사항을 알릴지 여부를 지정합니다.

사용자 프로필을 업데이트하거나 WM_SETTINGCHANGE 메시지를 브로드캐스트하지 않으려면 이 매개 변수가 0이거나 다음 값 중 하나 이상이 될 수 있습니다.

의미
SPIF_UPDATEINIFILE
새 시스템 전체 매개 변수 설정을 사용자 프로필에 씁니다.
SPIF_SENDCHANGE
사용자 프로필을 업데이트한 후 WM_SETTINGCHANGE 메시지를 브로드캐스트합니다.
SPIF_SENDWININICHANGE
SPIF_SENDCHANGE 동일합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 사용자가 환경을 사용자 지정할 수 있는 애플리케이션과 함께 사용하기 위한 것입니다.

키보드 레이아웃 이름은 레이아웃에 해당하는 언어 식별자의 16진수 값에서 파생되어야 합니다. 예를 들어 미국 영어에는 0x0409 언어 식별자가 있으므로 기본 미국 영어 레이아웃의 이름은 "00000409"입니다. Dvorak 레이아웃과 같은 미국 영어 레이아웃의 변형 이름은 "00010409", "00020409" 등입니다. 언어 식별자를 구성하는 기본 언어 식별자 및 하위 언어 식별자 목록은 MAKELANGID 매크로를 참조하세요.

고대비 색 구성표와 고대비 모드 간에는 차이가 있습니다. 고대비 색 구성표는 시스템 색을 명백한 대비가 있는 색으로 변경합니다. 제어판의 표시 옵션을 사용하여 이 색 구성표로 전환합니다. SPI_GETHIGHCONTRASTSPI_SETHIGHCONTRAST 사용하는 고대비 모드는 시각 장애가 있는 사용자의 모양을 수정하도록 애플리케이션에 권고합니다. 여기에는 사용자에게 가청 경고 및 사용자 지정된 색 구성표(제어판의 접근성 옵션 사용)와 같은 항목이 포함됩니다. 자세한 내용은 HIGHCONTRAST를 참조하세요. 일반적인 접근성 기능에 대한 자세한 내용은 접근성을 참조 하세요.

마우스 ClickLock 기능을 활성화하기 위해 기본 단추를 누른 동안 사용자는 마우스를 이동할 수 있습니다. 기본 단추가 잠기면 기본 단추를 해제해도 WM_LBUTTONUP 메시지가 표시되지 않습니다. 따라서 기본 단추가 여전히 다운된 것으로 애플리케이션에 표시됩니다. 후속 단추 메시지는 기본 단추를 해제하여 애플리케이션에 WM_LBUTTONUP 메시지를 보내므로 프로그래밍 방식으로 또는 단추를 클릭하는 사용자를 통해 단추를 잠금 해제할 수 있습니다.

이 API는 DPI를 인식하지 못하며 호출 스레드가 모니터별 DPI 인식인 경우 사용하면 안 됩니다. 이 API의 DPI 인식 버전은 SystemParametersInfoForDPI를 참조하세요. DPI 인식에 대한 자세한 내용은 Windows High DPI 설명서를 참조하세요.

예제

다음 예제에서는 SystemParametersInfo를 사용하여 마우스 속도를 두 배로 꿉니다.


#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")    

void main()  
{     
    BOOL fResult;
    int aMouseInfo[3];    // Array for mouse information
    
    // Get the current mouse speed.         
    fResult = SystemParametersInfo(SPI_GETMOUSE,   // Get mouse information
                                   0,              // Not used
                                   &aMouseInfo,    // Holds mouse information
                                   0);             // Not used           
                                   
    // Double it.         
    if( fResult )     
    {
        aMouseInfo[2] = 2 * aMouseInfo[2];
        
        // Change the mouse speed to the new value.
        SystemParametersInfo(SPI_SETMOUSE,      // Set mouse information
                             0,                 // Not used
                             aMouseInfo,        // Mouse information
                             SPIF_SENDCHANGE);  // Update Win.ini
    }  
}

참고

winuser.h 헤더는 SYSTEMParametersInfo를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-sysparams-ext-l1-1-0(Windows 8에서 도입)

추가 정보

ACCESSTIMEOUT

ANIMATIONINFO

AUDIODESCRIPTION

FILTERKEYS

Highcontrast

ICONMETRICS

Logfont

MAKELANGID

MINIMIZEDMETRICS

마우스

NONCLIENTMETRICS

RECT

직렬키

SOUNDSENTRY

고정키

SystemParametersInfoForDPI

토글키

WM_SETTINGCHANGE

Windows 데이터 형식