EngTransparentBlt 함수(winddi.h)

아티클
08/27/2023

EngTransparentBlt 함수는 투명도를 갖춘 비트 블록 전송 기능을 제공합니다.

구문

ENGAPI BOOL EngTransparentBlt(
  [in]           SURFOBJ  *psoDst,
  [in]           SURFOBJ  *psoSrc,
  [in, optional] CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDst,
  [in]           RECTL    *prclSrc,
  [in]           ULONG    TransColor,
  [in]           ULONG    bCalledFromBitBlt
);

매개 변수

[in] psoDst

그릴 대상 표면을 식별하는 SURFOBJ 구조체에 대한 포인터입니다.

[in] psoSrc

비트 블록 전송의 원본 표면을 식별하는 SURFOBJ 구조체에 대한 포인터입니다.

[in, optional] pco

CLIPOBJ 구조체에 대한 포인터입니다. CLIPOBJ_Xxx 서비스 루틴은 클립 영역을 사각형 집합으로 열거하기 위해 제공됩니다. 이 열거형은 수정된 대상의 영역을 제한합니다. 가능하면 GDI는 관련된 클리핑을 간소화합니다.

[in, optional] pxlo

대상 표면에 쓰기 위해 원본 색 인덱스를 변환하는 방법을 알려주는 XLATEOBJ 구조체에 대한 포인터입니다.

[in] prclDst

수정할 사각형 영역을 정의하는 RECTL 구조체에 대한 포인터입니다. 이 사각형은 대상 표면의 좌표계에 지정되며 왼쪽 위와 오른쪽 아래의 두 점으로 정의됩니다. 사각형은 오른쪽 아래에 배타적입니다. 즉, 아래쪽 및 오른쪽 가장자리는 비트 블록 전송의 일부가 아닙니다. 사각형을 정의하는 두 점은 항상 순서가 잘 정렬됩니다.

드라이버는 빈 대상 사각형을 사용하여 EngTransparentBlt 를 호출해서는 안 됩니다.

[in] prclSrc

복사할 사각형 영역을 정의하는 RECTL 구조체에 대한 포인터입니다. 이 사각형은 원본 표면의 좌표계에 지정되며 왼쪽 위와 오른쪽 아래의 두 점으로 정의됩니다. 사각형을 정의하는 두 점은 항상 순서가 잘 정렬됩니다.

원본 사각형은 원본 표면의 범위를 초과하지 않으므로 원본 표면을 오버행하지 않습니다.

이 사각형은 prclDst로 정의된 대상 사각형에 매핑됩니다. 드라이버는 빈 원본 사각형을 사용하여 EngTransparentBlt 를 호출해서는 안 됩니다.

[in] TransColor

원본 표면의 형식으로 실제 투명 색을 지정합니다. 원본 표면의 색상표로 변환된 색 인덱스 값입니다. 자세한 내용은 설명 섹션을 참조하세요.

[in] bCalledFromBitBlt

예약되어 있습니다. 이 매개 변수는 0으로 설정해야 합니다.

반환 값

EngTransparentBlt는 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.

설명

드라이버가 DrvTransparentBlt 를 후크하고 지원하지 않는 작업을 수행하도록 호출된 경우 EngTransparentBlt 를 호출해야 합니다.

투명도가 있는 비트 블록 전송은 두 디바이스 관리 표면 간 또는 디바이스 관리 표면 과 GDI 관리 표준 형식 비트맵 간에 지원됩니다. 현재 GDI는 BMF_4BPP 및 BMF_8BPP 원본 표면만 지원합니다.

iTransparentColor로 지정된 투명한 색과 일치하는 원본 표면의 픽셀은 복사되지 않습니다. 투명한 Blt에 대한 자세한 설명은 비트맵 복사를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	winddi.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys