DrvLineTo 함수(winddi.h)

아티클
03/15/2023

DrvLineTo 함수는 단일 단색 정수 전용 화장품 선을 그립니다.

구문

BOOL DrvLineTo(
  SURFOBJ  *pso,
  CLIPOBJ  *pco,
  BRUSHOBJ *pbo,
  LONG     x1,
  LONG     y1,
  LONG     x2,
  LONG     y2,
  RECTL    *prclBounds,
  MIX      mix
);

매개 변수

pso

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

pco

렌더링을 수행해야 하는 클립 영역을 정의하는 CLIPOBJ 구조체에 대한 포인터입니다. 이 클립 영역 외부에는 픽셀의 영향을 받을 수 없습니다.

pbo

선을 그릴 때 사용할 브러시를 지정하는 BRUSHOBJ 구조체에 대한 포인터입니다.

x1

선 시작점의 정수 x 좌표를 지정합니다.

y1

선 시작점의 정수 y 좌표를 지정합니다.

x2

선 끝점의 정수 x 좌표를 지정합니다.

y2

선 끝점의 정수 y 좌표를 지정합니다.

prclBounds

잘리지 않은 선을 경계로 하는 정수 사각형을 정의하는 RECTL 구조체에 대한 포인터입니다. 하드웨어 선 그리기를 지원하는 드라이버는 이 사각형을 사용하여 선이 하드웨어에서 렌더링할 수 있을 만큼 작은 좌표 공간에 맞는지 여부를 빠르게 확인할 수 있습니다.

mix

브러시에 사용할 전경 및 배경 래스터 작업을 정의하는 혼합 모드입니다. DrvLineTo 호출에서 포그라운드 및 백그라운드 래스터 작업 값은 동일합니다. 혼합 모드에 대한 자세한 내용은 비고를 참조하세요.

반환 값

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

설명

DrvLineTo 는 드라이버가 Win32 LineTo 함수에 대한 애플리케이션 호출에 대한 최적화로 제공할 수 있는 선택적 진입점입니다. 드라이버가 DrvLineTo를 후크하지 않거나 드라이버가 이 함수에 대한 호출에서 FALSE 를 반환하는 경우 GDI는 DrvStrokePath 를 대신 자동으로 호출합니다. DrvLineTo를 후크한 드라이버는 렌더링 표면이 DIB일 때 EngLineTo를 호출할 수 있습니다.

이 함수는 정수 끝점과 단색 화장품 선만 지원하므로 DrvStrokePath 보다 간단합니다. GDI는 DrvStrokePath 대신 DrvLineTo를 호출할 때 오버헤드가 적습니다. 따라서 DrvLineTo는 하드웨어에서 명목 너비 선을 가속화할 수 있는 드라이버의 간단한 최적화로 사용됩니다.

혼합 모드는 들어오는 패턴을 디바이스 화면에 이미 있는 데이터와 혼합하는 방법을 정의합니다. MIX 데이터 형식은 단일 ULONG으로 압축된 두 개의 ROP2(이진 래스터 작업) 값으로 구성됩니다. 가장 낮은 순서의 바이트는 전경 래스터 작업을 정의합니다. 다음 바이트는 백그라운드 래스터 작업을 정의합니다. 래스터 작업 코드에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.