DD_GETDRIVERINFODATA 構造体 (ddrawint.h)

DD_GETDRIVERINFODATA構造体は、 DdGetDriverInfo コールバック ルーチンとの間でデータを渡すために使用されます。

構文

typedef struct _DD_GETDRIVERINFODATA {
  VOID    *dhpdev;
  DWORD   dwSize;
  DWORD   dwFlags;
  GUID    guidInfo;
  DWORD   dwExpectedSize;
  PVOID   lpvData;
  DWORD   dwActualSize;
  HRESULT ddRVal;
} *PDD_GETDRIVERINFODATA, DD_GETDRIVERINFODATA;

メンバー

dhpdev

ドライバーの PDEV を処理します。 Microsoft Windows 2000 以降のみ。

dwSize

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

dwFlags

現在使用されておらず、0 に設定されています。

guidInfo

ドライバーのクエリを実行する Microsoft DirectX サポートの GUID を指定します。 Windows 2000 以降の Microsoft DirectDraw ドライバーでは、このメンバーは次のいずれかの値 (アルファベット順) にすることができます。

dwExpectedSize

DirectDraw がドライバーが lpvData を指すバッファーに戻す必要があるデータのバイト数を指定します。

lpvData

ドライバーが要求されたデータをコピーする DirectDraw によって割り当てられたバッファーを指します。 通常、このバッファーのサイズは dwExpectedSize バイトです。 ドライバーは、その中の データの dwExpectedSize バイトを超えて書き込む必要があります。 ドライバーは、 dwActualSize メンバー内のこのバッファーに書き込むバイト数を指定します。

dwActualSize

ドライバーが lpvData に書き込むデータのバイト数を返す場所を指定します。

ddRVal

ドライバーが DdGetDriverInfo コールバックの戻り値を書き込む場所を指定します。 DD_OKのリターン コードは成功を示します。 詳細については、「 DirectDraw の戻り値」を参照してください。

注釈

DdGetDriverInfo 呼び出しのためにドライバーに渡されるデータ構造には、Windows 98/Me と Windows 2000 以降の間に若干の違いがあります。 Windows 2000 以降では、データ構造は DD_GETDRIVERINFODATA と呼ばれ、Windows 98/Me ではデータ構造は DDHAL_GETDRIVERINFODATA と呼ばれます。 どちらのデータ構造にも、ドライバー固有のコンテキスト情報のフィールドが含まれています。 Windows 2000 以降では、DD_GETDRIVERINFODATAには、呼び出されるドライバーの DHPDEV を格納するフィールド dhpdev が含まれています。 Windows 98/Me でのみ、DDHAL_GETDRIVERINFODATAには、DirectDraw グローバル オブジェクトのドライバー予約 dwReserved3 フィールド用にコピーされたフィールド dwContext が含まれます。

要件

こちらもご覧ください

DdGetDriverInfo