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 部分に Direct3D ランタイムの D3dParseUnknownCommandCallback を提供します。 ドライバーの 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 が含まれます。

要件

要件 値
Header ddrawint.h (Winddi.h を含む)

こちらもご覧ください

DdGetDriverInfo