DrvGetDirectDrawInfo 関数 (winddi.h)

[アーティクル]
03/09/2024

DrvGetDirectDrawInfo 関数は、グラフィックスハードウェアの機能を返します。

構文

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

パラメーター

dhpdev

ドライバーの DrvEnablePDEV ルーチンによって返される PDEV へのハンドル。

pHalInfo

ドライバーがサポートするハードウェア機能を返す必要がある DD_HALINFO 構造体を指します。

pdwNumHeaps

pvmList が指す VIDEOMEMORY 構造体の数をドライバーが返す場所をポイントします。

pvmList

ドライバーが制御する各表示メモリチャンクに関する情報を返す VIDEOMEMORY 構造体の配列を指します。ドライバーは 、NULL の場合、このパラメーターを無視する必要があります。

pdwNumFourCCCodes

ドライバーが pdwFourCC が指す DWORD の数を返す場所をポイントします。

pdwFourCC

ドライバーがサポートする各 FOURCC に関する情報を返す DWORD の配列を指します。ドライバーは 、NULL の場合、このパラメーターを無視する必要があります。

戻り値

成功した場合、DrvGetDirectDrawInfo は TRUE を返します。それ以外の場合は、FALSE を返します。

注釈

ドライバーの DrvGetDirectDrawInfo ルーチンでは、次の操作を行う必要があります。

pvmList と pdwFourCC が NULL の場合:
1. DirectDraw で使用するためにオフスクリーン表示メモリを予約します。
2. ドライバー表示メモリヒープとサポートされている FOURCC の数をそれぞれ pdwNumHeaps と pdwNumFourCC に書き込みます。
pvmList と pdwFourCC が NULL でない場合:
1. ドライバー表示メモリヒープとサポートされている FOURCC の数をそれぞれ pdwNumHeaps と pdwNumFourCC に書き込みます。
2. pvmList がポイントするリスト内の VIDEOMEMORY 構造体ごとに、適切なメンバーを入力して、表示メモリの特定のチャンクを記述します。構造体の一覧には、ドライバーのオフスクリーンメモリの完全な説明が DirectDraw に用意されています。
ドライバー固有の情報を使用して、DD_HALINFO 構造体のメンバーを次のように初期化します。
1. vmiData で VIDEOMEMORYINFO 構造体の適切なメンバーを初期化して、ディスプレイのメモリの一般的な特性を記述します。
2. ddCaps で DDCORECAPS 構造体の適切なメンバーを初期化して、ハードウェアの機能を記述します。
3. ドライバーが DdGetDriverInfo 関数を実装する場合は、それをポイントするように GetDriverInfo を設定し、 dwFlags を DDHALINFO_GETDRIVERINFOSET に設定します。