IDirectDraw7::CreatePalette 메서드(ddraw.h)
이 DirectDraw 개체에 대한 DirectDrawPalette 개체를 만듭니다.
구문
HRESULT CreatePalette(
[in] DWORD unnamedParam1,
[in] LPPALETTEENTRY unnamedParam2,
[out] LPDIRECTDRAWPALETTE *unnamedParam3,
[in] IUnknown *unnamedParam4
);
매개 변수
[in] unnamedParam1
이 값은 다음 플래그 중 하나 이상으로 구성됩니다.
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_INITIALIZE
사용되지 않습니다. DirectDraw는 항상 lpDDColorArray에 전달된 색 배열의 색으로 이 팔레트를 초기화합니다.
DDPCAPS_PRIMARYSURFACE
이 색상표는 기본 표면에 연결됩니다. 이 색상표의 색 테이블을 변경하면 DDPSETPAL_VSYNC 지정되고 지원되지 않는 한 디스플레이에 즉시 영향을 줍니다.
DDPCAPS_PRIMARYSURFACELEFT
이 팔레트는 왼쪽 눈의 기본 표면에 부착된 색상표입니다. 이 색상표의 색 표를 변경하면 DDPSETPAL_VSYNC 지정되고 지원되지 않는 한 왼쪽 눈 표시에 즉시 영향을 줍니다.
DDPCAPS_VSYNC
이 팔레트는 모니터의 새로 고침 빈도와 동기화되도록 수정할 수 있습니다.
[in] unnamedParam2
DirectDrawPalette 개체를 초기화하기 위한 2, 4, 16 또는 256 PALETTEENTRY 구조체 배열의 주소입니다.
[out] unnamedParam3
호출이 성공하면 유효한 IDirectDrawPalette 인터페이스 포인터로 설정할 변수의 주소입니다.
[in] unnamedParam4
COM 집계 기능과의 향후 호환성을 허용합니다. 현재 이 매개 변수가 NULL이 아닌 경우 이 메서드는 오류를 반환합니다.
반환 값
메서드가 성공하면 반환 값이 DD_OK.
실패하면 메서드는 다음 오류 값 중 하나를 반환할 수 있습니다.
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | ddraw.h |
| 라이브러리 | Ddraw.lib |
| DLL | Ddraw.dll |