다음을 통해 공유


IPrintOemUni::D ownloadCharGlyph 메서드(prcomoem.h)

메서드 IPrintOemUni::DownloadCharGlyph 를 사용하면 Unidrv용 렌더링 플러그 인이 지정된 소프트 글꼴의 문자 모양을 프린터로 보낼 수 있습니다.

구문

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

매개 변수

pdevobj

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

pUFObj

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

hGlyph

호출자 제공 문자 모양 핸들입니다.

pdwWidth

문자의 메서드 제공 너비를 수신하기 위한 호출자 제공 포인터입니다.

[out] pdwResult

문자 문자 모양을 저장하는 데 필요한 프린터 메모리의 양을 바이트 단위로 나타내는 메서드 제공 값을 받습니다. 작업이 실패하면 반환된 값은 0이어야 합니다.

반환 값

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

반환 코드 Description
S_OK
작업에 성공했습니다.
E_FAIL
작업이 실패했습니다.
E_NOTIMPL
메서드가 구현되지 않았습니다.

설명

메서드는 IPrintOemUni::DownloadCharGlyphPCL 명령을 허용하지 않는 프린터에서 소프트 글꼴을 지원하는 데 사용됩니다. 그 목적은 렌더링 플러그 인이 문자 문자 모양을 프린터로 보낼 수 있도록 하는 것입니다.

렌더링 플러그 인이 메서드를 구현 IPrintOemUni::DownloadCharGlyph 하는 경우 Unidrv는 프린터의 GPD 파일에 포함된 CmdSetCharCode 명령 항목에 지정된 명령 문자열을 보낸 직후 메서드를 호출합니다. (GPD 파일은 Microsoft 유니버설 프린터 드라이버에 설명되어 있습니다.) 메서드는 다음을 수행해야 합니다.

  • UNIFONTOBJ_GetInfo 함수를 호출하여 hGlyph로 지정된 문자 모양 이미지를 가져옵니다.
  • IPrintOemDriverUni::D rvWriteSpoolBuf를 호출하여 문자 모양을 프린터로 보냅니다.
  • UNIFONTOBJ_GetInfo 함수를 다시 호출하여 문자 모양 너비를 가져온 다음 pdwWidth가 가리키는 주소에 너비를 저장합니다.
  • pdwResult에서 지정한 위치에 배치하여 문자 모양을 저장하는 데 필요한 프린터 메모리 양을 반환합니다.
메서드는 IPrintOemUni::DownloadCharGlyph 선택 사항입니다. 렌더링 플러그 인이 이 메서드를 구현하는 경우 플러그 인의 IPrintOemUni::GetImplementedMethod 메서드는 "DownloadCharGlyph"를 입력으로 수신할 때 S_OK 반환해야 합니다.

메서드를 구현하는 IPrintOemUni::DownloadCharGlyph 경우 IPrintOemUni::D ownloadFontHeader 메서드도 구현해야 합니다.

자세한 내용은 사용자 지정된 글꼴 관리를 참조하세요.

요구 사항

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