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 句柄,则显示微型端口驱动程序应失败,其当前运行的 DDI 函数STATUS_INVALID_HANDLE。

言论

若要 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