PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB回调函数 (d3dumddi.h)

项目
02/23/2024

在指定上下文直接内存访问中的指定同步对象上插入信号 (DMA) 流。由 WDDM 1.2 及更高版本的用户模式显示驱动程序使用。

语法

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECT2CB Pfnd3dddiSignalsynchronizationobject2cb;

HRESULT Pfnd3dddiSignalsynchronizationobject2cb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 *unnamedParam2
)
{...}

参数

hDevice

显示设备 (句柄，即图形上下文) 。

unnamedParam2

pData [in]

指向 D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 结构的指针，该结构描述设置信号的同步对象和上下文 DMA 流。

返回值

返回以下值之一：

返回代码	说明
S_OK	信号已成功设置。
E_INVALIDARG	参数已验证并确定为不正确。

此函数还可能返回其他 HRESULT 值。

注解

pfnCreateSynchronizationObject2Cb 函数向 pData 参数指向的 D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 结构 hSyncObject 成员中新创建的同步对象返回内核模式句柄。用户模式显示驱动程序在调用以下函数时将此句柄传递：

pfnSignalSynchronizationObject2Cb 函数将信号命令提交到由D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2结构的 hContext 和 BroadcastContext 成员指定的所有 Microsoft Direct3D 上下文的命令流。仅当处理所有提交的信号命令时，才会向同步对象发出信号。

如果同步对象的类型 D3DDDI_FENCE (其中D3DDDI_SYNCHRONIZATIONOBJECTINFO2。类型 = D3DDDI_FENCE) ，一次只能提交一个，并且D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2。ObjectCount 的值必须为 1。