NtGdiDdLockD3D 関数

  • [アーティクル]

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

バッファー メモリの指定された領域をロックし、バッファーに関連付けられているメモリ ブロックへの有効なポインターを提供するために使用されます。

構文

DWORD APIENTRY NtGdiDdLockD3D(
  _In_    HANDLE       hSurface,
  _Inout_ PDD_LOCKDATA puLockData
);

パラメーター

hSurface [in]

ロック ダウンするメモリ 領域に関連付けられているサーフェスを記述するDD_SURFACE_LOCAL構造体へのポインター。

puLockData [in, out]

ロック ダウンの実行 に必要な情報を含むDD_LOCKDATA構造体へのポインター。

戻り値

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

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

関連項目

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