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 |