DrvQueryFontData 함수(winddi.h)

아티클
08/27/2023

DrvQueryFontData 함수는 실현된 글꼴에 대한 정보를 검색합니다.

구문

LONG DrvQueryFontData(
        DHPDEV    dhpdev,
        FONTOBJ   *pfo,
        ULONG     iMode,
        HGLYPH    hg,
        GLYPHDATA *pgd,
  [out] PVOID     pv,
        ULONG     cjSize
);

매개 변수

dhpdev

DrvEnablePDEV에 대한 이전 호출에서 반환된 물리적 디바이스의 PDEV에 대한 핸들입니다.

pfo

글꼴 실현을 정의하는 FONTOBJ 구조체에 대한 포인터입니다.

iMode

요청된 정보의 유형을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
QFD_GLYPHANDBITMAP	pgd가 NULL이 아닌 경우 드라이버는 hg로 지정된 문자 모양 메트릭으로 GLYPHDATA 구조를 채워야 합니다. pv가 NULL이 아니면 이 주소에 GLYPHBITS 구조체를 작성해야 합니다. 드라이버는 hg 로 지정된 문자 모양에 해당하는 문자 모양 비트맵을 이 구조체에 복사해야 합니다. 구조체의 크기는 cjSize로 지정됩니다. 드라이버에서 문자 모양 비트맵을 지원하지 않는 경우 이 함수는 pv 가 NULL로 설정된 상태에서만 호출됩니다. 드라이버가 문자 모양 비트맵을 지원하는 경우 반환 값은 문자 모양 비트맵의 크기(바이트)입니다. 그렇지 않으면 0입니다. 이 모드는 지원되어야 합니다.
QFD_GLYPHANDOUTLINE	pgd가 NULL이 아닌 경우 드라이버는 hg로 지정된 문자 모양 메트릭으로 GLYPHDATA 구조를 채워야 합니다. pv가 NULL이 아닌 경우 PATHOBJ 구조체를 이 주소에 작성해야 합니다. 드라이버는 이 PATHOBJ를 PATHOBJ_Xxx 서비스에 전달하여 hg로 지정된 문자 모양에 대한 개요를 만듭니다. cjSize 매개 변수는 무시해야 합니다. 함수가 성공하면 반환 값은 0입니다. 그렇지 않으면 FD_ERROR. 문자 모양 윤곽선을 제공하는 글꼴 드라이버만 이 모드를 지원해야 합니다.
QFD_MAXEXTENTS	pv가 NULL이 아닌 경우 드라이버는 pv가 가리키는 버퍼에 FD_DEVICEMETRICS 구조를 작성해야 합니다. 반환 값은 pv 가 NULL인 경우 버퍼에 필요한 크기(바이트)입니다.
QFD_TT_GRAY1_BITMAP	실현된 글꼴은 회색조의 픽셀당 1비트(즉, 검은색 또는 흰색)로 렌더링되어야 합니다.
QFD_TT_GRAY2_BITMAP	실현된 글꼴은 픽셀당 2비트 회색조로 렌더링되어야 합니다.
QFD_TT_GRAY4_BITMAP	실현된 글꼴은 픽셀당 4비트 회색조로 렌더링되어야 합니다.
QFD_TT_GRAY8_BITMAP	실현된 글꼴은 픽셀당 8비트 회색조로 렌더링되어야 합니다.
QFD_TT_MONO_BITMAP	QFD_TT_GRAY1_BITMAP 동일합니다.

hg

문자 모양에 대한 핸들입니다.

pgd

GLYPHDATA 구조체에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

[out] pv

데이터 버퍼에 대한 포인터입니다. 이 버퍼에 기록된 데이터 형식은 iMode에 따라 달라집니다. 이 매개 변수는 NULL일 수 있습니다.

cjSize

pv에서 가리키는 버퍼의 크기를 지정합니다.

반환 값

반환 값은 iMode 매개 변수의 값에 따라 달라집니다. 오류가 발생하면 반환 값이 FD_ERROR 오류 코드가 기록됩니다.

설명

iMode 매개 변수의 QFD_GLYPHANDBITMAP 및 QFD_GLYPHANDOUTLINE 값의 경우 GDI는 GLYPHDATA 구조체(pgd 매개 변수)에 대한 포인터를 제공합니다. 드라이버는 이 구조체에 문자 모양 메트릭에 대한 정보를 배치하고 글꼴이 비트맵 글꼴인지 윤곽선 글꼴인지에 따라 각각 pv 매개 변수로 지정된 위치에 GLYPHBITS 구조체 또는 PATHOBJ 구조체의 내용을 씁니다. iMode 매개 변수의 QFD_MAXEXTENTS 값에 대해 드라이버는 pv 매개 변수로 지정된 위치에 FD_DEVICEMETRICS 구조체의 내용을 씁니다.

DrvQueryFontData 는 디바이스별 또는 드라이버별 글꼴을 사용하는 글꼴 드라이버 및 드라이버에 필요합니다.