다음을 통해 공유


EngTransparentBlt 함수(winddi.h)

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

추가 정보

DrvBitBlt

DrvPlgBlt

DrvStretchBlt

DrvStretchBltROP

DrvTransparentBlt

EngBitBlt

EngPlgBlt

EngStretchBlt

EngStretchBltROP