DrvQueryPerBandInfo 함수(winddi.h)

프린터 그래픽 DLL의 DrvQueryPerBandInfo 함수는 물리적 페이지에 대한 밴드 그리기를 시작하기 전에 GDI에서 호출되므로 드라이버는 GDI에 대역별 정보를 제공할 수 있습니다.

구문

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

매개 변수

[in] pso

그리기 표면을 설명하는 SURFOBJ 구조체에 대한 호출자 제공 포인터입니다.

[in, out] pbi

함수가 덮어쓸 수 있는 기본 정보를 포함하는 PERBANDINFO 구조체에 대한 호출자 제공 포인터입니다.

반환 값

함수는 다음 값 중 하나를 반환해야 합니다.

반환 코드	설명
0보다 큼	GDI는 PERBANDINFO 구조체의 내용을 사용합니다.
Zero	GDI는 PERBANDINFO 구조체의 내용을 무시합니다.
DDI_ERROR	GDI는 밴드를 그리지 않습니다.

설명

프린터 그래픽 DLL이 GDI 관리형 표면을 사용하고 표면 줄무늬를 지원하는 경우 필요에 따라 DrvQueryPerBandInfo 함수를 제공할 수 있습니다. GDI는 각 밴드를 렌더링하기 전에 함수를 호출합니다.

프린터 그래픽 DLL은 함수의 PERBANDINFO 구조를 사용하여 이전 밴드를 다시 그려야 하는지 여부를 나타내고 대역의 크기를 조정하도록 지정합니다. 프린터 그래픽 DLL이 밴딩을 지원하지만 DrvQueryPerBandInfo 함수를 제공하지 않는 경우 GDI는 대역을 반복하거나 스케일링하지 않습니다.

DrvQueryPerBandInfo 함수는 EMF 파일을 재생하는 동안에만 호출됩니다.

요구 사항

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

추가 정보

DrvNextBand

DrvStartBanding