通过

NtGdiD3DContextCreate 函数

  • 项目

[此函数可能会随每个操作系统修订版而更改。 请改用 Microsoft DirectDraw 和 Microsoft Direct3DAPI;这些 API 将应用程序与此类操作系统更改隔离开来，并隐藏与显示驱动程序直接交互时涉及的许多其他困难。]

创建上下文。

语法

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

参数

hDirectDrawLocal [in]

内核模式 DirectDraw 对象的句柄，该对象以前使用 NtGdiDdCreateDirectDrawObject 创建，表示要在其中创建 Direct3D 上下文的设备。

hSurfColor [in]

描述要用作 呈现 目标的 DirectDraw 图面的DD_SURFACE_LOCAL结构的句柄。

hSurfZ [in]

描述要用作深度缓冲区的 DirectDraw 图面的 DD_SURFACE_LOCAL 结构的句柄。 如果此成员为 NULL，则不执行深度缓冲。

pdcci [in， out]

指向 D3DNTHAL_CONTEXTCREATEDATA 结构的指针，该结构包含创建上下文所需的信息和驱动程序应存储在新上下文中的数据。

返回值

NtGdiD3DContextCreate 返回以下回调代码之一。

返回代码 说明
DDHAL_DRIVER_HANDLED
 驱动程序已执行该操作并返回该操作的有效返回代码。 如果此代码DD_OK，则 DirectDraw 或 Direct3D 将继续执行 函数。 否则，DirectDraw 或 Direct3D 将返回驱动程序提供的错误代码并中止该函数。
DDHAL_DRIVER_NOTHANDLED
 驱动程序对请求的操作没有注释。 如果驱动程序需要实现特定的回调，DirectDraw 或 Direct3D 将报告错误条件。 否则，DirectDraw 或 Direct3D 会像未通过执行与 DirectDraw 或 Direct3D 设备无关的实现来定义驱动程序回调一样处理操作。

 

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Ntgdi.h

另请参阅

图形低级别客户端支持