DdCreateDIBSection 함수(ddrawgdi.h)

아티클
08/23/2023

[이 함수는 각 운영 체제 수정 버전에 따라 변경될 수 있습니다. 대신 Microsoft DirectDraw 및 Microsoft Direct3DAPIs를 사용합니다. 이러한 API는 이러한 운영 체제 변경으로부터 애플리케이션을 격리하고 디스플레이 드라이버와 직접 상호 작용하는 데 관련된 다른 많은 어려움을 숨깁니다.]

해당 색 테이블을 디바이스와 공유하는 DIBSECTION 구조를 만듭니다.

GdiEntry9 는 이 함수의 별칭으로 정의됩니다.

구문

HBITMAP DdCreateDIBSection(
  HDC              hdc,
  const BITMAPINFO *pbmi,
  UINT             iUsage,
  VOID             **ppvBits,
  HANDLE           hSectionApp,
  DWORD            dwOffset
);

매개 변수

hdc

현재 디스플레이 디바이스와 호환되는 유효한 DC입니다.

pbmi

요청된 DIBSECTION을 설명하는 BITMAPINFO 구조체에 대한 포인터입니다.

iUsage

pbmi가 가리키는 BITMAPINFO 구조체의 bmiColors 배열 멤버에 포함된 데이터의 형식을 지정합니다(논리적 색상표 인덱스 또는 리터럴 RGB 값). 다음 값이 정의됩니다.

(DIB_PAL_COLORS)

bmiColors 멤버는 hdc로 지정된 디바이스 컨텍스트의 논리적 팔레트에 대한 16비트 인덱스의 배열입니다.

(DIB_RGB_COLORS)

BITMAPINFO 구조체에는 리터럴 RGB 값의 배열이 포함되어 있습니다.

ppvBits

생성된 DIBSECTION 데이터에 대한 포인터에 대한 포인터입니다.

hSectionApp

예약되어 있습니다. NULL이어야 합니다.

dwOffset

반환 값

성공하면 이 함수는 DIBSECTION을 나타내는 비트맵에 대한 핸들을 반환합니다. 그렇지 않으면 NULL을 반환합니다.

설명

이 함수를 호출하면 ID 팔레트가 보장되고 IDirectDrawSurface7::Blt 또는 StretchBlt 가 호출될 때 색상표 변환이 수행되지 않습니다.

애플리케이션은 운영 체제와 독립적인 방식으로 픽셀당 8비트 ID 팔레트 표면을 만들 수 있는 IDirectDrawSurface7을 사용하는 것이 좋습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ddrawgdi.h

추가 정보

그래픽 하위 수준 클라이언트 지원

Share via