FONTOBJ_cGetGlyphs 함수(winddi.h)

아티클
08/27/2023

FONTOBJ_cGetGlyphs 함수는 문자 모양 핸들을 문자 모양 데이터에 대한 포인터로 변환하는 글꼴 소비자에 대한 서비스로, FONTOBJ_cGetGlyphs 다음 호출까지 유효합니다.

구문

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

매개 변수

pfo

번역할 문자 모양 핸들을 포함하는 FONTOBJ 구조체에 대한 포인터입니다.

[in] iMode

데이터를 비트맵 또는 개요 개체로 쓸지 여부를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
FO_GLYPHBITS	데이터는 문자 모양의 비트맵을 정의하는 GLYPHBITS 구조로 구성됩니다.
FO_PATHOBJ	데이터는 문자 모양 윤곽선을 정의하는 PATHOBJ 구조체로 구성됩니다. 경로를 채우거나 스트로크할지 여부를 확인하려면 글꼴 소비자가 IFIMETRICS 구조체의 flInfo 멤버를 검사 합니다. FM_INFO_RETURNS_STROKES 플래그가 설정되면 경로를 스트로크해야 합니다. 그렇지 않으면 경로를 채워야 합니다.

cGlyph

번역할 문자 모양 수를 지정합니다. 허용되는 유일한 값은 1입니다(코드는 지정된 값에 관계없이 1을 가정합니다).

phg

드라이버에서 제공하는 cGlyph HGLYPH 구조체의 배열에 대한 포인터입니다.

ppvGlyph

GLYPHDATA 구조체의 주소를 받는 메모리 위치에 대한 포인터입니다. 이 구조체의 첫 번째 멤버는 iMode 매개 변수의 값에 따라 GLYPHBITS 구조체 또는 PATHOBJ 구조체에 대한 포인터를 포함하는 GLYPHDEF 공용 구조체입니다. iMode 값이 FO_GLYPHBITS 경우 (ppvGlyph)->gdf에는 GLYPHBITS 구조체의 주소가 포함됩니다. iMode 값이 FO_PATHOBJ 경우 (ppvGlyph)->gdf에는 PATHOBJ 구조체의 주소가 포함됩니다.

반환 값

반환 값은 함수가 성공한 경우 드라이버에 전달된 포인터의 수입니다. 그렇지 않으면 0이고 오류 코드가 기록됩니다.

설명

드라이버가 글꼴을 캐싱하는 경우 이 함수를 사용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	winddi.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys