NtGdiDdDestroySurface 関数

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

以前に割り当てられたカーネル モードの Microsoft DirectDraw サーフェス オブジェクトを破棄します。

構文

DWORD APIENTRY NtGdiDdDestroySurface(
  _In_ HANDLE hSurface,
  _In_ BOOL   bRealDestroy
);

パラメーター

hSurface [in]

以前に割り当てられたカーネル モード サーフェス オブジェクトを処理します。

bRealDestroy [in]

サーフェスを破棄する方法を指定します。 次のいずれかの値を指定できます。

(TRUE)

サーフェスを破棄し、ビデオ メモリを解放します。

(FALSE)

ビデオ メモリを解放しますが、サーフェスは初期化されていない状態のままにします。

戻り値

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

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

 

解説

アプリケーションでは、DirectDraw API と Direct3D API を使用して、この関数の代わりにサーフェスを作成および破棄することをお勧めします。

必要条件

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

関連項目

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