Bewerken

Delen via


D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2 structure (d3dkmthk.h)

The D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2 structure contains information about the synchronization events that the D3DKMTSignalSynchronizationObject2 function signals.

Syntax

typedef struct _D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2 {
  [in] D3DKMT_HANDLE        hContext;
  [in] UINT                 ObjectCount;
       D3DKMT_HANDLE        ObjectHandleArray[D3DDDI_MAX_OBJECT_SIGNALED];
  [in] D3DDDICB_SIGNALFLAGS Flags;
  [in] ULONG                BroadcastContextCount;
       D3DKMT_HANDLE        BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  union {
    struct {
      D3DKMT_ALIGN64 UINT64 FenceValue;
    } Fence;
         HANDLE                CpuEventHandle;
         D3DKMT_ALIGN64 UINT64 Reserved[8];
  };
} D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2;

Members

[in] hContext

A kernel-mode handle to a context that signals the synchronization events in the array that the ObjectHandleArray member specifies.

[in] ObjectCount

The number of synchronization events in the ObjectHandleArray array.

[in] ObjectHandleArray[D3DDDI_MAX_OBJECT_SIGNALED]

An array of kernel-mode handles to the synchronization events that the context that is specified by the hContext member signals. The D3DDDI_MAX_OBJECT_SIGNALED constant, which is defined as 32, indicates the maximum number of synchronization events that the context can signal.

[in] Flags

A D3DDDICB_SIGNALFLAGS structure that indicates, in bit-field flags, signaling behavior.

[in] BroadcastContextCount

The number of additional contexts in the array that BroadcastContext specifies.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

An array of D3DKMT_HANDLE data types that represent kernel-mode handles to the additional contexts to broadcast the event to. The D3DDDI_MAX_BROADCAST_CONTEXT constant, which is defined as 64, defines the maximum number of contexts that the OpenGL ICD can broadcast the event to.

The original context that the hContext member specifies and that owns the event is not an element in the BroadcastContext array. For example, if the BroadcastContext array contains one element, the OpenGL ICD sends the event to the owning context (hContext) and broadcasts to that one additional context.

Fence

A structure that contains information about a fence. The union in D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2 can hold a Fence structure, which contains the following member:

Fence.FenceValue

A 64-bit value that specifies the fence value to signal.

CpuEventHandle

A handle to a CPU event that is to be signaled.

Supported starting with Windows 8.

Reserved[8]

An array of 64-bit values that are reserved for future use. The union in D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2 can hold this array.

Requirements

Requirement Value
Minimum supported client D3DKMT_SIGNALSYNCHRONIZATIONOBJECT2 is supported beginning with the Windows 7 operating system.
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DDDICB_SIGNALFLAGS

D3DKMTSignalSynchronizationObject2