DXGKCB_GETHANDLEPARENT回调函数 (d3dkmddi.h)

DXGKCB_GETHANDLEPARENT 从指定的分配中检索父资源。

语法

DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;

D3DKMT_HANDLE DxgkcbGethandleparent(
  [in] IN_D3DKMT_HANDLE hAllocation
)
{...}

参数

[in] hAllocation

分配的句柄。 此句柄必须是 DirectX 图形内核子系统 (Dxgkrnl.sys) 分配的内核模式句柄。

返回值

DXGKCB_GETHANDLEPARENT 将特定于图形子系统的句柄返回到与 hAllocation 参数指定的句柄关联的分配的父资源。

如果 DXGKCB_GETHANDLEPARENT 返回 NULL 句柄, Dxgkrnl.sys 无法将句柄解析为父资源,原因如下:

  • 由于恶意攻击或其他一些 bug,从用户模式显示驱动程序收到无效句柄。
  • 分配有生存期问题。

如果返回 NULL 句柄,显示微型端口驱动程序应会因STATUS_INVALID_HANDLE而使当前运行的 DDI 函数失败。

注解

使DXGKCB_GETHANDLEPARENT 返回资源句柄, hAllocation 中的句柄必须是与资源关联的分配句柄;否则, DXGKCB_GETHANDLEPARENT 返回 NULL。

DXGKCB_XXX 函数由 Dxgkrnl 实现。 若要使用此回调函数,请通过 DXGKRNL_INTERFACE调用 DxgkCbGetHandleParent

要求

要求
最低受支持的客户端 Windows Vista (WDDM 1.0)
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL < DISPATCH_LEVEL

另请参阅

DXGKRNL_INTERFACE