IPrintOemUni3::SetBandSize 메서드(prcomoem.h)

이 메서드는 IPrintOemUni3::SetBandSize Unidrv 지원 프린터와 함께 사용하여 인쇄된 출력에서 원하는 대역 크기를 지정할 수 있습니다.

구문

HRESULT SetBandSize(
  [in] PDEVOBJ pdevobj,
  [in] INT     iFormat,
  [in] DWORD   dwPageWidthBytes,
  [in] DWORD   dwPageHeight,
  [in] DWORD   dwMaxHeight,
  [in] PDWORD  pdwRequiredHeight
);

매개 변수

[in] pdevobj

DEVOBJ 구조체에 대한 호출자 제공 포인터입니다.

[in] iFormat

필요한 픽셀당 색 정보의 비트 수 측면에서 비트맵의 형식을 지정하는 정수 값입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
BMF_1BPP	단색
BMF_4BPP	픽셀당 4비트
BMF_8BPP	픽셀당 8비트
BMF_16BPP	픽셀당 16비트
BMF_24BPP	픽셀당 24비트
BMF_32BPP	픽셀당 32비트
BMF_4RLE	픽셀당 4비트; 실행 길이 인코딩됨
BMF_8RLE	픽셀당 8비트; 실행 길이 인코딩됨

[in] dwPageWidthBytes

인쇄 영역의 너비를 바이트 단위로 지정하는 Unidrv 제공 값입니다.

[in] dwPageHeight

인쇄 영역의 높이를 픽셀 단위로 지정하는 Unidrv 제공 값입니다.

[in] dwMaxHeight

인쇄 영역의 최대 허용 높이(픽셀)를 지정하는 Unidrv 제공 값입니다.

[in] pdwRequiredHeight

렌더링 플러그 인에 필요한 인쇄 영역의 높이를 픽셀 단위로 포함하는 DWORD에 대한 호출자 제공 포인터입니다.

반환 값

메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드	Description
S_OK	작업에 성공했습니다. 참고를 참조하십시오.
E_FAIL	작업이 실패했습니다. 참고를 참조하십시오.
E_NOTIMPL	Unidrv는 밴딩 크기를 계산해야 합니다.

설명

이 메서드는 Windows Vista 이상에서 사용할 수 있습니다.

이 메서드는 렌더링 플러그 인에서 Unidrv의 대역 크기 계산을 사용하는 대신 플러그 인의 자체 계산을 사용하여 대역 크기를 지정하는 데 사용됩니다.

dwPageHeight 값을 *pdwRequiredHeight로 설정하여 Unidrv에서 줄무늬 작업을 사용하지 않도록 설정할 수 있지만 렌더링 플러그 인이 요청하는 높이 값의 성능 효과를 고려해야 합니다. 렌더링을 위해 Unidrv에는 dwPageWidthBytes 를 *pdwRequiredHeight에 곱하여 계산되는 메모리 양이 적어도 필요합니다. 렌더링 플러그 인이 IPrintOemUni::D riverDMS 메서드를 지원하고 해당 메서드가 "S_OK"을 반환하는 경우 이 IPrintOemUni3::SetBandSize 호출되지 않습니다.

이 메서드가 정의되고 프린터의 GPD(일반 프린터 설명) 파일이 사전 분석이 비활성화되었음을 나타내는 경우(GPD 파일에 "*PreAnalysisOptions: 0"이 포함됨) Unidrv는 이 메서드를 호출하여 대역 크기를 계산합니다. PreAnalysisOptions 특성에 대한 자세한 내용은 사전 분석 인프라를 참조하세요.

렌더링 플러그 인이 IPrintOemUni::D riverDMS 를 지원하고 해당 메서드가 S_OK IPrintOemUni3::SetBandSize 반환하는 경우 이 호출되지 않습니다.

요구 사항

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