NtGdiD3DContextCreate 関数

  • [アーティクル]

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

コンテキストを作成します。

構文

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

パラメーター

hDirectDrawLocal [in]

以前に NtGdiDdCreateDirectDrawObject を使用して作成されたカーネル モードの DirectDraw オブジェクトを処理します。これは、Direct3D コンテキストを作成するデバイスを表します。

hSurfColor [in]

レンダリング ターゲットとして使用する DirectDraw サーフェスを記述する DD_SURFACE_LOCAL 構造体を処理します。

hSurfZ [in]

深度バッファーとして使用する DirectDraw サーフェスを記述する DD_SURFACE_LOCAL 構造体へのハンドル。 このメンバーが NULL の場合、深度バッファリングは実行されません。

pdcci [in, out]

コンテキストの作成に必要な情報と、ドライバーが新しいコンテキストに格納する必要があるデータを含むD3DNTHAL_CONTEXTCREATEDATA構造体へのポインター。

戻り値

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

リターン コード 説明
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

関連項目

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