NtGdiDdCreateD3DBuffer 関数

  • [アーティクル]

[この機能は、オペレーティング システムのリビジョンごとに変更される場合があります。 代わりに、Microsoft DirectDraw と Microsoft Direct3DAPIs を使用します。これらの API は、このようなオペレーティング システムの変更からアプリケーションを保護し、ディスプレイ ドライバーとの直接の対話に関連する他の多くの困難を隠します。

指定した説明のドライバー レベルのコマンドまたは頂点バッファーを作成するために使用します。

構文

DWORD APIENTRY NtGdiDdCreateD3DBuffer(
  _In_    HANDLE               hDirectDraw,
  _Inout_ HANDLE               *hSurface,
  _Inout_ DDSURFACEDESC        *puSurfaceDescription,
  _Inout_ DD_SURFACE_GLOBAL    *puSurfaceGlobalData,
  _Inout_ DD_SURFACE_LOCAL     *puSurfaceLocalData,
  _Inout_ DD_SURFACE_MORE      *puSurfaceMoreData,
  _Inout_ DD_CREATESURFACEDATA *puCreateSurfaceData,
  _Inout_ HANDLE               *puhSurface
);

パラメーター

hDirectDraw [in]

ドライバーを表す DD_DIRECTDRAW_GLOBAL 構造体へのハンドル。

hSurface [in, out]

サーフェス ハンドルの配列へのポインター。 モード切り替え後にサーフェスを再作成する場合、呼び出し元はこれらのハンドルを前のハンドル値に設定できます。 このプロセスは、DirectDraw ドキュメントの "復元" と呼ばれます。

puSurfaceDescription [in, out]

ドライバーが作成する必要があるサーフェスまたはバッファーを記述する DDSURFACEDESC 構造体へのポインター。

puSurfaceGlobalData [in, out]

複数 のサーフェス とグローバルに共有されるサーフェス データを含むDD_SURFACE_GLOBAL構造体へのポインター。

puSurfaceLocalData [in, out]

ドライバーによって作成されたサーフェス オブジェクトを記述する DD_SURFACE_LOCAL 構造体の一覧へのポインター。 通常、この配列には 1 つのエントリしかありません。

puSurfaceMoreData [in, out]

追加のローカル サーフェス データを含む DD_SURFACE_MORE 構造体へのポインター。

puCreateSurfaceData [in, out]

バッファーの作成に必要な情報を含む DD_CREATESURFACEDATA 構造体へのポインター。

puhSurface [in, out]

DirectDraw API によって使用され、ドライバーで入力しないでください。

戻り値

NtGdiDdCreateD3DBuffer は 、次のいずれかのコールバック コードを返します。

リターン コード 説明
DDHAL_DRIVER_HANDLED
 ドライバーは操作を実行し、その操作の有効なリターン コードを返しました。 このコードがDD_OKされている場合、DirectDraw または Direct3D は 関数を続行します。 それ以外の場合、DirectDraw または Direct3D はドライバーによって提供されるエラー コードを返し、関数を中止します。
DDHAL_DRIVER_NOTHANDLED
 ドライバーには、要求された操作に対するコメントはありません。 ドライバーが特定のコールバックを実装する必要がある場合、DirectDraw または Direct3D はエラー状態を報告します。 それ以外の場合、DirectDraw または Direct3D は、DirectDraw または Direct3D デバイスに依存しない実装を実行してドライバーコールバックが定義されていないかのように操作を処理します。

 

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Ntgdi.h

関連項目

グラフィックスの低レベルクライアントサポート