D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 结构 (d3dumddi.h)

描述在调用 pfnSignalSynchronizationObject2Cb 函数时设置信号所需的参数。

语法

typedef struct _D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 {
  [in] HANDLE               hContext;
  [in] UINT                 ObjectCount;
       D3DKMT_HANDLE        ObjectHandleArray[D3DDDI_MAX_OBJECT_SIGNALED];
  [in] D3DDDICB_SIGNALFLAGS Flags;
  [in] ULONG                BroadcastContextCount;
       HANDLE               BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  union {
    [in] UINT64 FenceValue;
    [in] HANDLE CpuEventHandle;
  };
} D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2;

成员

[in] hContext

Direct3D 上下文的句柄,该句柄向 ObjectHandleArray 成员指定的数组中的同步事件发出信号。

[in] ObjectCount

ObjectHandleArray 数组中的同步事件数。

[in] ObjectHandleArray[D3DDDI_MAX_OBJECT_SIGNALED]

hContext 成员指定的上下文发出信号的同步事件的句柄数组。 D3DDDI_MAX_OBJECT_SIGNALED常量(定义为 32)指示上下文可以发出信号的最大同步事件数。

必须在 与 hContext 指定的上下文相同的逻辑适配器上创建所有同步对象。

[in] Flags

一个D3DDDICB_SIGNALFLAGS结构,指示在位字段标志中发出信号的行为。

[in] BroadcastContextCount

要将此信号缓冲区广播到的上下文数。

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

一个由D3DKMT_HANDLE数据类型构成的数组,这些数据类型表示内核模式句柄,这些句柄指向将当前信号命令广播到的其他上下文。 D3DDDI_MAX_BROADCAST_CONTEXT常量(定义为 64)定义上下文可以向其发出信号的最大同步事件数。

必须为同一 Direct3D 设备和 hContext 指定的上下文创建所有上下文。

[in] FenceValue

一个 64 位值,指定 GPU 同步对象的当前围栏值。

仅当 GPU 同步对象的类型为 D3DDDI_FENCE 时,此值才适用,即 D3DDDI_SYNCHRONIZATIONOBJECTINFO2 结构的 Type 成员的值为 D3DDDI_FENCE

[in] CpuEventHandle

处理信号命令时将发出信号的事件对象的句柄。 仅当 标志时,必须设置此成员。指定 EnqueueCpuEvent

要求

要求
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDICB_SIGNALFLAGS

D3DDDI_SYNCHRONIZATIONOBJECTINFO2

pfnSignalSynchronizationObject2Cb