DXGKDDI_CREATEDEVICE回调函数 (d3dkmddi.h)

  • 项目

DXGKDDI_CREATEDEVICE 函数创建图形上下文设备，该设备随后用于调用显示微型端口驱动程序的设备特定函数。

语法

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

NTSTATUS DxgkddiCreatedevice(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}

参数

hAdapter

[in]与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序之前在 DXGKDDI_ADD_DEVICE 函数的 MiniportDeviceContext 输出参数中向 Dxgkrnl 提供了此句柄。

pCreateDevice

[in/out]指向描述图形上下文设备的 DXGKARG_CREATEDEVICE 结构的指针。

返回值

DXGKDDI_CREATEDEVICE 返回以下值之一：

返回代码 说明
STATUS_SUCCESS DXGKDDI_CREATEDEVICE 已成功创建图形上下文设备。
STATUS_NO_MEMORY DXGKDDI_CREATEDEVICE 无法分配完成该操作所需的内存。

注解

Dxgkrnl 调用显示微型端口驱动程序的 DXGKDDI_CREATEDEVICE 函数来创建图形上下文设备，图形子系统随后将该设备传入显示微型端口驱动程序的调用。 驱动程序使用设备来保存呈现状态的集合。 图形子系统可以在给定的图形处理单元上在同一进程中创建多个设备， (GPU) 适配器。

注意

可同时存在的设备数仅受可用系统内存的限制。 也就是说，驱动程序不能具有硬编码的最大设备限制。

通常，设备彼此独立;换句话说，在另一台设备中创建的资源不能引用或访问在一台设备中创建的资源。 但是，跨进程资源是此规则的例外。

应使DXGKDDI_CREATEDEVICE 可分页。

要求

要求 值
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_CREATEDEVICE

DXGKDDI_ADD_DEVICE