通过

DXGKDDI_DESTROYMEMORYBASIS回调函数 (d3dkmddi.h)

  • 项目

KMD 的 DxgkDdiDestroyMemoryBasis 函数会破坏先前调用 DxgkDdiCreateMemoryBasis 创建的内存基础。

语法

DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;

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

参数

hAdapter

[in]与显示适配器关联的上下文块的句柄。 KMD 以前在 DxgiDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 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