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) |