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 |