drvQueryFontCaps 函式 (winddi.h)

DrvQueryFontCaps 函式會定義字型驅動程式的功能。

語法

LONG DrvQueryFontCaps(
  ULONG culCaps,
  ULONG *pulCaps
);

culCaps

指定可由字型驅動程式寫入之 pulCaps 參數所指向之陣列中的 ULONG 值數目。

pulCaps

陣列的指標，該陣列會接收第一個參數中指定的值數目。陣列的專案具有下列意義：

元素	意義
pulCaps[0]	完整數位中 ULONG 值的計數。如果 culCaps 小於此值，則呼叫端將會收到不完整的數位列。
pulCaps[1]	一組旗標，可以是下列一或多個值： QC_OUTLINES 如果設定此旗標，字型驅動程式可以傳回字元的大綱描述。此外，會假設字型可調整。點陣圖字型未設定此旗標。 QC_1BIT 表示字型驅動程式能夠傳回每個字元的單色位圖。 QC_4BIT 表示字型驅動程式能夠傳回每個圖元的反鋸齒 4 位位元圖。位圖中的每個像素都會以範圍 0 到 15 中的不帶正負號 4 位值來表示，產生 16 個灰色陰影。

元素

意義

pulCaps[0]

完整數位中 ULONG 值的計數。如果 culCaps 小於此值，則呼叫端將會收到不完整的數位列。

pulCaps[1]

一組旗標，可以是下列一或多個值：

QC_4BIT
表示字型驅動程式能夠傳回每個圖元的反鋸齒 4 位位元圖。位圖中的每個像素都會以範圍 0 到 15 中的不帶正負號 4 位值來表示，產生 16 個灰色陰影。

如果函式成功，傳回值是寫入目的地緩衝區的 ULONG 值數目。否則，它會FD_ERROR。

驅動程式可能會報告它支援一個以上的字型格式。例如，驅動程式可以傳回並同時設定QC_1BIT和QC_4BIT，表示其能夠同時傳回單色和反鋸齒版本的字型。字型驅動程式所產生的所有位圖都必須以32位界限開始和結束。如有必要，位圖的結尾應該「填補」以符合此需求。

需求	值
目標平台	桌面
標頭	winddi.h (包含Winddi.h)