DD_HALINFO 構造体 (ddrawint.h)

DD_HALINFO構造では、ハードウェアとドライバーの機能について説明します。

構文

typedef struct _DD_HALINFO {
  DWORD               dwSize;
  VIDEOMEMORYINFO     vmiData;
  DDNTCORECAPS        ddCaps;
  PDD_GETDRIVERINFO   GetDriverInfo;
  DWORD               dwFlags;
  LPVOID              lpD3DGlobalDriverData;
  LPVOID              lpD3DHALCallbacks;
  PDD_D3DBUFCALLBACKS lpD3DBufCallbacks;
} DD_HALINFO, *PDD_HALINFO;

メンバー

dwSize

このDD_HALINFO構造体のサイズをバイト単位で指定します。

vmiData

ディスプレイのメモリを記述する VIDEOMEMORYINFO 構造体を指定します。

ddCaps

ドライバー固有の機能を含む DDNTCORECAPS 構造体を指定します。

GetDriverInfo

ドライバーの DdGetDriverInfo 関数を 指します。 この関数は、さらに Microsoft DirectDraw ドライバー情報を取得するために呼び出されます。 このメンバーは NULL にすることができます。

dwFlags

ディスプレイ ドライバーの作成フラグを指定します。 このメンバーは、次のいずれかの値のビットごとの OR です。

フラグ	説明
DDHALINFO_ISPRIMARYDISPLAY	ドライバーはプライマリ ディスプレイ ドライバーです。
DDHALINFO_MODEXILLEGAL	このハードウェアでは、ModeX モードはサポートされていません。
DDHALINFO_GETDRIVERINFOSET	GetDriverInfo メンバーが設定されています。
DDHALINFO_GETDRIVERINFO2	ドライバーでは、 GetDriverInfo2 バリアントの GetDriverInfo がサポートされています。

lpD3DGlobalDriverData

ドライバーとそのデバイスの 3D 機能を記述する D3DHAL_GLOBALDRIVERDATA 構造体を指します。

lpD3DHALCallbacks

ドライバーの初期化 されたD3DHAL_CALLBACKS構造体を 指します。

lpD3DBufCallbacks

ドライバー レベルの頂点とコマンド バッファーの割り当てを実装するドライバーでのみ使用されます。 これは通常、パフォーマンス上の理由から行われます。 lpD3DBufCallbacks メンバーは、ドライバーマネージド頂点バッファーとコマンド バッファーをサポートするために使用されるコールバックでドライバーが入力するDD_D3DBUFCALLBACKS構造体へのポインターです。 通常、このメンバーはドライバーによって無視されます。

解説

GDI は、DD_HALINFO構造体を割り当ててゼロ初期化し、ドライバー固有のデータで初期化するドライバーの DrvGetDirectDrawInfo ルーチンに渡します。

必要条件

Header	ddrawint.h (Winddi.h を含む)

関連項目

D3DHAL_CALLBACKS

D3DHAL_GLOBALDRIVERDATA

DDCORECAPS

DD_D3DBUFCALLBACKS

DdGetDriverInfo

DrvGetDirectDrawInfo

VIDEOMEMORYINFO