DXGKDDI_CREATEOVERLAY回调函数 （d3dkmddi.h）

DxgkDdiCreateOverlay 函数启用覆盖硬件（如果硬件支持）。

语法

DXGKDDI_CREATEOVERLAY DxgkddiCreateoverlay;

NTSTATUS DxgkddiCreateoverlay(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_CREATEOVERLAY pCreateOverlay
)
{...}

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序以前向 MiniportDeviceContext 中的 Microsoft DirectX 图形内核子系统提供了此句柄，DxgkDdiAddDevice 函数的输出参数。

[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