IDirectDrawPalette::GetCaps 메서드(ddraw.h)
색상표 개체의 기능을 검색합니다.
구문
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
매개 변수
[out] unnamedParam1
색상표 기능을 정의하는 DDCAPS 구조체의 dwPalCaps 멤버로부터 값을 받는 변수에 대한 포인터입니다. 이 값은 다음 플래그 중 하나 이상으로 구성됩니다.
DDPCAPS_1BIT
인덱스는 1비트입니다. 색 표에는 두 개의 항목이 있습니다.
DDPCAPS_2BIT
인덱스는 2비트입니다. 색 표에는 네 개의 항목이 있습니다.
DDPCAPS_4BIT
인덱스는 4비트입니다. 색 표에는 16개의 항목이 있습니다.
DDPCAPS_8BIT
인덱스는 8비트입니다. 색 테이블에는 256개의 항목이 있습니다.
DDPCAPS_8BITENTRIES
인덱스는 8비트 색 인덱스를 참조합니다. 이 플래그는 DDPCAPS_1BIT, DDPCAPS_2BIT 또는 DDPCAPS_4BIT 플래그와 함께 사용하고 대상 표면이 8bpp인 경우에만 유효합니다. 각 색 항목은 1바이트 길이이며 대상 표면의 8bpp 팔레트에 대한 인덱스입니다.
DDPCAPS_ALPHA
연결된 PALETTEENTRY 구조체의 peFlags 멤버는 단일 8비트 알파 값(peRed, peGreen 및 peBlue 멤버 외에)으로 해석되어야 합니다. 이 플래그를 사용하여 만든 색상표는 텍스처(DDSCAPS_TEXTURE 기능 플래그로 만든 표면)에만 연결할 수 있습니다.
DDPCAPS_ALLOW256
이 팔레트에는 256개의 항목이 모두 정의되었을 수 있습니다.
DDPCAPS_PRIMARYSURFACE
이 색상표는 기본 표면에 연결됩니다. 이 색상표의 색 테이블을 변경하면 DDPSETPAL_VSYNC 지정되고 지원되지 않는 한 디스플레이에 즉시 영향을 줍니다.
DDPCAPS_PRIMARYSURFACELEFT
이 팔레트는 왼쪽 눈의 기본 표면에 부착된 색상표입니다. 이 색상표의 색 표를 변경하면 DDPSETPAL_VSYNC 지정되고 지원되지 않는 한 왼쪽 눈 표시에 즉시 영향을 줍니다.
DDPCAPS_VSYNC
이 팔레트는 모니터의 새로 고침 빈도와 동기화되도록 수정할 수 있습니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |