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

另请参阅

DXGKARG_CREATEOVERLAY

DxgkDdiAddDevice