DXGKDDI_UPDATEOVERLAY回调函数 (d3dkmddi.h)
DxgkDdiUpdateOverlay 函数修改覆盖硬件。
语法
DXGKDDI_UPDATEOVERLAY DxgkddiUpdateoverlay;
NTSTATUS DxgkddiUpdateoverlay(
[in] IN_CONST_HANDLE hOverlay,
[in] IN_CONST_PDXGKARG_UPDATEOVERLAY pUpdateOverlay
)
{...}
参数
[in] hOverlay
要修改的覆盖的句柄。 显示微型端口驱动程序的 DxgkDdiCreateOverlay 函数之前向 pCreateOverlay 指向的 DXGKARG_CREATEOVERLAY 结构的 hOverlay 成员中的 Microsoft DirectX 图形内核子系统提供了此句柄。
[in] pUpdateOverlay
指向描述如何修改覆盖硬件 的DXGKARG_UPDATEOVERLAY 结构的指针。
返回值
DxgkDdiUpdateOverlay 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_SUCCESS | DxgkDdiUpdateOverlay 已成功修改覆盖层。 |
| STATUS_INVALID_PARAMETER | 传递给 DxgkDdiUpdateOverlay 的参数包含阻止其完成的错误。 |
| STATUS_NO_MEMORY | DxgkDdiUpdateOverlay 无法分配完成该任务所需的内存。 |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiUpdateOverlay 无法完成，因为可用带宽不足或请求的覆盖硬件无法完成任务。 |
| STATUS_GRAPHICS_DRIVER_MISMATCH | 显示微型端口驱动程序与发起对 DxgkDdiUpdateOverlay 调用的用户模式显示驱动程序不兼容。 |
注解
应使 DxgkDdiUpdateOverlay 可分页。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |