DXGKDDI_CREATEDEVICE回调函数 (d3dkmddi.h)

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

语法

DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;

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

参数

hAdapter

[in]与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序以前提供了此句柄,用于在 MiniportDeviceContextDxgiDdiAddDevice 函数的输出参数中 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