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 成员信号指定的上下文的同步事件的句柄数组。 定义为 32 的 D3DDDI_MAX_OBJECT_SIGNALED 常量指示上下文可以发出的最大同步事件数。

必须在与 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 结构的 类型 成员具有 D3DDDI_FENCE值。

[in] CpuEventHandle

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

要求

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

另请参阅

D3DDDICB_SIGNALFLAGS

D3DDDI_SYNCHRONIZATIONOBJECTINFO2

pfnSignalSynchronizationObject2Cb