DrvRealizeBrush 함수(winddi.h)

DrvRealizeBrush 함수는 드라이버가 지정된 표면에 대해 지정된 브러시를 인식하도록 요청합니다.

구문

BOOL DrvRealizeBrush(
  [in]           BRUSHOBJ *pbo,
  [in, out]      SURFOBJ  *psoTarget,
  [in]           SURFOBJ  *psoPattern,
  [in, optional] SURFOBJ  *psoMask,
  [in]           XLATEOBJ *pxlo,
  [in]           ULONG    iHatch
);

매개 변수

[in] pbo

실현할 BRUSHOBJ 구조체에 대한 포인터입니다. psoTarget을 제외한 다른 모든 매개 변수는 이 개체에서 쿼리할 수 있습니다. 매개 변수 사양은 최적화로 제공됩니다. 이 매개 변수는 실현된 브러시에 대한 메모리를 할당하는 BRUSHOBJ_pvAllocRbrush 매개 변수로만 사용하는 것이 가장 좋습니다.

[in, out] psoTarget

브러시를 실현할 SURFOBJ 구조체에 대한 포인터입니다. 이 표면은 디바이스의 물리적 표면, 디바이스 형식 비트맵 또는 표준 형식 비트맵일 수 있습니다.

[in] psoPattern

브러시의 패턴을 설명하는 SURFOBJ 구조체에 대한 포인터입니다. 래스터 디바이스의 경우 비트맵입니다. 벡터 디바이스의 경우 DrvEnablePDEV에서 제공하는 패턴 표면 중 하나입니다.

[in, optional] psoMask

브러시의 투명도 마스크를 설명하는 SURFOBJ 구조체에 대한 포인터입니다. 이는 패턴과 동일한 익스텐트인 픽셀당 1비트 비트맵입니다. 마스크가 0이면 픽셀이 브러시의 배경 픽셀로 간주됩니다. 투명 배경 모드에서는 배경 픽셀이 채우기에 영향을 받지 않습니다. 플로터는 배경 정보를 그리지 않으므로 이 매개 변수를 무시할 수 있습니다.

[in] pxlo

패턴의 색 해석을 정의하는 XLATEOBJ 구조체에 대한 포인터입니다. pxlo가 NULL인 경우 변환이 필요하지 않습니다. XLATEOBJ_Xxx 서비스 루틴을 호출하여 색을 디바이스 색 인덱스로 변환할 수 있습니다. 벡터 디바이스는 XLATEOBJ를 통해 색 0을 변환하여 브러시의 전경색을 가져와야 합니다.

[in] iHatch

psoPattern이 DrvEnablePDEV에서 반환하는 해치 브러시 중 하나인지 여부를 지정합니다. 이 매개 변수의 값이 winddi.h에 정의된 HS_DDI_MAX 미만이면 true입니다.

반환 값

브러시가 성공적으로 실현된 경우 반환 값은 TRUE 입니다. 그렇지 않으면 FALSE이고 오류 코드가 기록됩니다.

설명

브러시를 실현하기 위해 드라이버는 GDI 브러시를 내부적으로 사용할 수 있는 형식으로 변환합니다. 실현된 브러시에는 브러시를 사용하여 그리기를 가속화하는 데 필요한 디바이스별 정보가 포함되어 있습니다.

드라이버의 브러시 실현은 BRUSHOBJ_pvAllocRbrush 호출에 의해 할당된 버퍼에 기록됩니다.

DrvRealizeBrush 는 모든 표면에 그리는 드라이버에 필요합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	winddi.h(Winddi.h 포함)

추가 정보

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvEnablePDEV

XLATEOBJ