DEVINFO 構造体 (winddi.h)

DEVINFO 構造体は、ドライバーとそのプライベート PDEV に関する情報をグラフィックス エンジンに提供します。

構文

typedef struct tagDEVINFO {
  FLONG    flGraphicsCaps;
  LOGFONTW lfDefaultFont;
  LOGFONTW lfAnsiVarFont;
  LOGFONTW lfAnsiFixFont;
  ULONG    cFonts;
  ULONG    iDitherFormat;
  USHORT   cxDither;
  USHORT   cyDither;
  HPALETTE hpalDefault;
  FLONG    flGraphicsCaps2;
} DEVINFO, *PDEVINFO;

メンバー

flGraphicsCaps

グラフィックス ドライバーとそのハードウェアのグラフィックス機能を記述するフラグのセットです。 これらのフラグは、次の表で定義されています。

lfDefaultFont

デバイスの既定のフォントを指定する拡張論理フォント構造体です。 この構造の詳細については、Microsoft Windows SDKドキュメントの EXTLOGFONT を参照してください。

lfAnsiVarFont

デバイスの既定の可変ピッチ フォントを指定する拡張論理フォント構造体です。 この構造の詳細については、Windows SDKドキュメントの EXTLOGFONT を参照してください。

lfAnsiFixFont

デバイスの既定の固定ピッチ (モノスペース) フォントを指定する拡張論理フォント構造体です。 この構造の詳細については、Windows SDKドキュメントの EXTLOGFONT を参照してください。

cFonts

デバイス フォントの数を指定します。 GDI は、デバイスが独自のサーフェス上にこの数のフォントでテキストを描画でき、ドライバーがフォントに関するメトリック情報を提供できることを前提としています。 ドライバーが cFonts を -1 に設定した場合、GDI は 、DrvQueryFont の呼び出しでサポートされているフォントの実際の数をドライバーに照会するためにフォントが必要になるまで待機します。

iDitherFormat

ビットマップの形式を指定します。 このパラメーターは、ピクセルごとに要求される色情報のビット数を示し、次のいずれかの値にする必要があります。

cxDither

cyDither

ディザリングブラシの寸法を指定します。 これらのメンバーが 0 以外の場合、デバイスは特定の RGB 色のディザリング ブラシを作成できます。

hpalDefault

デバイスの既定のパレットを処理します。 ドライバーは 、EngCreatePalette を呼び出してパレットを作成する必要があります。 ドライバーは、GDI にこのハンドルを返すことによって、デバイスにパレットを関連付けます。

flGraphicsCaps2

デバイス ドライバーの追加のグラフィックス機能を記述するフラグのセットです。 これらのフラグは、次の表で定義されています。

注釈

ドライバーの DrvEnablePDEV 関数は、DEVINFO 構造体を入力します。ドライバーは、それに関連するメンバーのみを設定する必要があります。 この構造体は、 DrvEnablePDEV が呼び出される前に GDI によってゼロ初期化されます。 アプリケーションは、この構造に直接アクセスできません。

ドライバーが flGraphicsCaps2 でGCAPS2_JPEGSRCまたはGCAPS2_PNGSRCを設定する場合は、次の規則が適用されます。

• ドライバーは 、DrvQueryDeviceSupport 関数を提供する必要があります。
• 入力として SURFOBJ 構造体を受け取るドライバー定義グラフィックス DDI 関数はすべて、圧縮形式をサポートするか、エラー コードを返すことができる必要があります。 プリンター ドライバーの場合、圧縮形式をサポートするには、ドライバーが次のいずれかのタスクを実行できる必要があります。
  • 印刷デバイスが JPEG/PNG 圧縮形式を処理できる場合、プリンター ドライバーは圧縮形式をそのページ記述言語 (PDL) 出力に渡す必要があります。
  • 印刷デバイスが JPEG/PNG 圧縮形式を処理できない場合、プリンター ドライバーはまず、圧縮された JPEG/PNG 形式を印刷デバイスで処理できる別のイメージ形式に変換する必要があります。 プリンター ドライバーは、ドライバーの PDL 出力でイメージ情報を使用できるようにします。
    メモ JPEG/PNG からビットマップ形式に変換する場合、プリンター ドライバーは GDI 関数を使用できません。 たとえば、ドライバーは、代わりに Windows イメージング コンポーネント (WIC) API を使用して変換を行うことができます。
     
• ドライバーは、圧縮形式を使用するイメージの複雑なクリップ領域を処理できる必要があります。
• ROP4 入力引数を受け取るドライバー定義グラフィックス DDI 関数の場合、JPEG および PNG 形式では0xCCCCのみが使用されます。

要件

こちらもご覧ください

DrvEnablePDEV

DrvQueryFont

DrvRealizeBrush

DrvTextOut