PFND3DDDI_GETOVERLAYCOLORCONTROLS 콜백 함수(d3dumddi.h)
GetOverlayColorControls 함수는 지정된 오버레이에 대한 색 제어 설정을 검색합니다.
구문
PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;
HRESULT Pfnd3dddiGetoverlaycolorcontrols(
HANDLE hDevice,
D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.
unnamedParam2
pData [in, out]
오버레이의 색 제어 설정을 검색하기 위한 매개 변수를 설명하는 D3DDDIARG_GETOVERLAYCOLORCONTROLS 구조체에 대한 포인터입니다.
반환 값
GetOverlayColorControls 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 색 제어 설정이 성공적으로 검색되었습니다. |
| E_INVALIDARG | 매개 변수의 유효성이 검사되었고 잘못된 것으로 확인되었습니다. |
| E_OUTOFMEMORY | GetOverlayColorControls에서 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
설명
Microsoft Direct3D 런타임은 GetOverlayColorControls 함수를 호출하여 특정 오버레이와 연결된 현재 밝기, 대비, 색조, 채도, 선명도, 감마 및 색 사용 설정을 반환합니다.
런타임은 아직 표시되지 않은 오버레이에 대해 GetOverlayColorControls 를 호출할 수도 있습니다. 이 경우 pData가 가리키는 D3DDDIARG_GETOVERLAYCOLORCONTROLS 구조체의 hOverlay 멤버가 NULL로 설정된 경우 드라이버는 오버레이 하드웨어의 기본 색 제어 설정을 반환해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |