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 ドライバーでは、このメンバーは次のいずれかの値 (アルファベット順) にすることができます。

GUID 説明
GUID_ColorControlCallbacks ドライバーが DdControlColor をサポートしているかどうかをクエリします。 ドライバーがサポートしている場合、ドライバーは初期化し、lpvData がポイントするバッファー内のDD_COLORCONTROLCALLBACKS構造体を返す必要があります。
GUID_D3DCallbacks ドライバーが、D3DHAL_CALLBACKS構造体で指定された機能のいずれかをサポートしているかどうかをクエリします。 ドライバーがこのサポートを提供していない場合は、初期化し、 lpvData がポイントするバッファー内のD3DHAL_CALLBACKS構造体を返す必要があります。
GUID_D3DCallbacks2 互換性のために残されています。
GUID_D3DCallbacks3 ドライバーが D3DHAL_CALLBACKS3 構造体で指定された機能のいずれかをサポートしているかどうかをクエリします。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のD3DHAL_CALLBACKS3構造体を返す必要があります。
GUID_D3DCaps 互換性のために残されています。
GUID_D3DExtendedCaps ドライバーが、D3DHAL_D3DEXTENDEDCAPS構造で指定された Microsoft Direct3D 機能のいずれかをサポートしているかどうかを照会します。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のD3DHAL_D3DEXTENDEDCAPS構造体を返す必要があります。
GUID_D3DParseUnknownCommandCallback Direct3D ランタイムの D3dParseUnknownCommandCallback を使用して、ドライバーの Direct3D 部分を提供します。 ドライバーの D3dDrawPrimitives2 コールバックは 、D3dParseUnknownCommandCallback を呼び出して、ドライバーが認識しないコマンド バッファーからコマンドを解析します。DirectDraw は、 lpvData が指すバッファー内のこの関数へのポインターを渡します。 ドライバーが Direct3D のこの側面をサポートしている場合は、ポインターを格納する必要があります。
GUID_GetHeapAlignment ドライバーがヒープごとにサーフェスの配置要件をサポートしているかどうかをクエリします。 ドライバーがこのサポートを提供する場合は、初期化し、lpvData がポイントするバッファー内のDD_GETHEAPALIGNMENTDATA構造体を返す必要があります。
GUID_KernelCallbacks ドライバーが 、DD_KERNELCALLBACKS 構造体で指定された機能のいずれかをサポートしているかどうかをクエリします。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のDD_KERNELCALLBACKS構造体を返す必要があります。
GUID_KernelCaps ドライバーが DDKERNELCAPS 構造体で指定されたカーネル モード機能のいずれかをサポートしているかどうかをクエリします。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内の DDKERNELCAPS 構造体を返す必要があります。
GUID_MiscellaneousCallbacks ドライバーが DdGetAvailDriverMemory をサポートしているかどうかをクエリします。 ドライバーがサポートしている場合、ドライバーは初期化し、lpvData がポイントするバッファー内のDD_MISCELLANEOUSCALLBACKS構造体を返す必要があります。
GUID_Miscellaneous2Callbacks ドライバーが DD_MISCELLANEOUS2CALLBACKS 構造で指定された追加のその他の機能をサポートしているかどうかをクエリします。 ドライバーがこのサポートのいずれかをサポートしている場合、ドライバーは初期化し、 lpvData がポイントするバッファー内のDD_MISCELLANEOUS2CALLBACKS構造体を返す必要があります。
GUID_MotionCompCallbacks ドライバーが 、DD_MOTIONCOMPCALLBACKS 構造体で指定されたモーション補正機能をサポートしているかどうかをクエリします。 ドライバーがこのサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のDD_MOTIONCOMPCALLBACKS構造体を返す必要があります。
GUID_NonLocalVidMemCaps ドライバーが、 DD_NONLOCALVIDMEMCAPS 構造体で指定された非ローカル表示メモリ機能をサポートしているかどうかを照会します。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のDD_NONLOCALVIDMEMCAPS構造体を返す必要があります。
GUID_NTCallbacks ドライバーが 、DD_NTCALLBACKS 構造体で指定された機能のいずれかをサポートしているかどうかを照会します。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のDD_NTCALLBACKS構造体を返す必要があります。
GUID_NTPrivateDriverCaps ドライバーが、 DD_NTPRIVATEDRIVERCAPS 構造で指定された Windows 98/Me スタイルのサーフェス作成手法をサポートしているかどうかをクエリします。 ドライバーは、このサポートのいずれかを提供する場合は、初期化し、 lpvData がポイントするバッファー内のDD_NTPRIVATEDRIVERCAPS構造体を返す必要があります。
GUID_UpdateNonLocalHeap ドライバーが各非ローカル ヒープのベース アドレスの取得をサポートしているかどうかをクエリします。 ドライバーがこのサポートを提供する場合は、初期化し、lpvData がポイントするバッファー内のDD_UPDATENONLOCALHEAPDATA構造体を返す必要があります。
GUID_VideoPortCallbacks ドライバーが ビデオ ポート拡張機能 (VPE) をサポートしているかどうかをクエリします。 ドライバーが VPE をサポートしている場合は、lpvData が指すバッファー内のDD_VIDEOPORTCALLBACKS構造体を初期化して返す必要があります。
GUID_VideoPortCaps ドライバーが DDVIDEOPORTCAPS 構造体を使用して指定された VPE オブジェクト機能のいずれかをサポートしているかどうかを照会します。 ドライバーがこのサポートのいずれかを提供する場合は、初期化し、 lpvData ポイント先のバッファー内の DDVIDEOPORTCAPS 構造体を返す必要があります。
GUID_ZPixelFormats 深度バッファーでサポートされているピクセル形式を照会します。 ドライバーが Direct3D をサポートしている場合は、サポートされているすべての z バッファー形式の DDPIXELFORMAT 構造体の適切なメンバーを割り当てて初期化し、 lpvData が指すバッファーでこれらを返す必要があります。

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 が含まれます。

要件

   
ヘッダー ddrawint.h (Winddi.h を含む)

こちらもご覧ください

DdGetDriverInfo