DXGKDDI_CREATEOVERLAY回调函数 (d3dkmddi.h)
DxgkDdiCreateOverlay 函数启用覆盖硬件（如果硬件能够）。
语法
DXGKDDI_CREATEOVERLAY DxgkddiCreateoverlay;
NTSTATUS DxgkddiCreateoverlay(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_CREATEOVERLAY pCreateOverlay
)
{...}
参数
[in] hAdapter
与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序之前在 DxgkDdiAddDevice 函数的 MiniportDeviceContext 输出参数中向 Microsoft DirectX 图形内核子系统提供了此句柄。
[in/out] pCreateOverlay
指向描述覆盖 的DXGKARG_CREATEOVERLAY 结构的指针。
返回值
DxgkDdiCreateOverlay 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_SUCCESS | DxgkDdiCreateOverlay 已成功创建覆盖层。 |
| STATUS_INVALID_PARAMETER | 传递给 DxgkDdiCreateOverlay 的参数包含阻止其完成的错误。 |
| STATUS_NO_MEMORY | DxgkDdiCreateOverlay 无法分配完成该操作所需的内存。 |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiCreateOverlay 无法完成，因为可用带宽不足或请求的覆盖硬件无法完成任务。 |
| STATUS_GRAPHICS_DRIVER_MISMATCH | 显示微型端口驱动程序与启动对 DxgkDdiCreateOverlay 调用的用户模式显示驱动程序不兼容。 |
注解
应使 DxgkDdiCreateOverlay 可分页。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | d3dkmddi.h (包括 D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |