DrvQueryTrueTypeTable 함수(winddi.h)

DrvQueryTrueTypeTable 함수는 TrueType 글꼴 설명 파일의 특정 테이블에 액세스합니다.

구문

LONG DrvQueryTrueTypeTable(
  ULONG_PTR iFile,
  ULONG     ulFont,
  ULONG     ulTag,
  PTRDIFF   dpStart,
  ULONG     cjBuf,
  BYTE      *pjBuf,
  PBYTE     *ppjTable,
  ULONG     *pcjTable
);

매개 변수

iFile

드라이버 제공 TrueType 글꼴 파일을 식별하는 드라이버 정의 값에 대한 포인터입니다. 이 포인터는 DrvLoadFontFile에서 가져옵니다.

ulFont

드라이버 글꼴의 1 기반 인덱스를 지정합니다.

ulTag

액세스할 테이블을 지정합니다. ulTag가 0이면 드라이버가 전체 파일에 대한 액세스를 반환해야 합니다.

dpStart

액세스를 시작할 테이블의 시작 부분에서 오프셋을 지정합니다. ulTag가 0이면 dpStart는 파일의 시작 부분에서 오프셋입니다.

cjBuf

pjBuf가 가리키는 버퍼의 크기(바이트) 또는 0을 지정합니다.

pjBuf

NULL이 아닌 경우 드라이버가 테이블 또는 글꼴 데이터를 복사해야 하는 버퍼를 가리킵니다.

ppjTable

NULL이 아닌 경우 드라이버가 테이블 또는 글꼴 데이터의 주소를 반환해야 하는 위치를 가리킵니다.

pcjTable

NULL이 아닌 경우 드라이버가 *ppjTable이 가리키는 테이블 또는 글꼴 데이터의 길이(바이트)를 반환해야 하는 위치를 가리킵니다.

반환 값

DrvQueryTrueTypeTable 은 다음 값 중 하나를 반환합니다.

• pjBuf가 NULL인 경우 버퍼가 전체 테이블을 보유하는 데 필요한 바이트 수입니다(pcjTable에서 반환된 값과 동일).
• pjBuf가 NULL이 아니면 복사된 바이트 수입니다.
• 오류가 발생하면 FD_ERROR.

설명

DrvQueryTrueTypeTable 은 TrueType 글꼴 드라이버에서 구현해야 합니다.

테이블 또는 글꼴 데이터를 반환하도록 DrvQueryTrueTypeTable 을 요청할 수 있는 두 가지 방법이 있습니다.

1. cjBuf나 pjBuf가 NULL이 아닌 경우 드라이버는 요청된 테이블의 내용을 pjBuf가 가리키는 버퍼에 복사해야 합니다. 이 경우 ppjTable 및 pcjTable 은 NULL 이며 드라이버에서 무시해야 합니다.
2. ppjTable이나 pcjTable이 NULL이 아닌 경우 드라이버는 테이블에 대한 포인터를 *ppjTable로, 테이블의 길이(바이트)를 *pciTable에 배치해야 합니다. 이 경우 cjBuf 및 pjBuf 는 NULL 이 되며 드라이버에서 무시해야 합니다.

요구 사항

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

추가 정보

DrvLoadFontFile