DXGKDDI_DESTROYMEMORYBASIS コールバック関数 (d3dkmddi.h)

KMD の DxgkDdiDestroyMemoryBasis 関数は、以前の DxgkDdiCreateMemoryBasisの呼び出しによって作成されたメモリベース破棄します。

構文

DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;

NTSTATUS DxgkddiDestroymemorybasis(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

パラメーター

hAdapter

[in]ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 KMD は以前、DxgiDdiAddDevice 関数の出力パラメーター ミニポートDeviceContext で Dxgkrnl を するために、このハンドルを提供しました。

hMemoryBasis

破棄するメモリベースへのハンドル。 このハンドルは、以前に DxgkDdiCreateMemoryBasis呼び出しによって作成されました。

戻り値

DxgkDdiDestroyMemoryBasis は、メモリベースが正常に破棄された場合にSTATUS_SUCCESSを返します。 それ以外の場合は、NTSTATUS エラー コードが返されます。 「解説」を参照してください。

備考

Dxgkrnl は、STATUS_SUCCESSされていない返された NTSTATUS を致命的なエラー通知の戻り値として解釈します。 この関数から成功以外のものを返す正しく機能するパスは存在しないはずです。これは、指定されたハンドルが作成されたもので、まだ破棄されていないものと想定されるためです。 KMD が不適切な入力を検出した場合、返されたエラー コードにより、Dxgkrnl 、ドライバーのクラッシュではなく、不変のエラーを OS カーネルに割り当てることができます。

詳細については、「ダーティ ビットトラッキング を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 11 バージョン 24H2 (WDDM 3.2)
ヘッダー	d3dkmddi.h
IRQL	PASSIVE_LEVEL

関連項目

DxgkDdiCreateMemoryBasisの