Redigera

Dela via


DXGKARGCB_SIGNALEVENT structure (d3dkmddi.h)

DXGKARGCB_SIGNALEVENT contains the arguments used by the DxgkCbSignalEvent callback function to signal an event.

Syntax

typedef struct _DXGKARGCB_SIGNALEVENT {
  HANDLE hDxgkProcess;
  HANDLE hEvent;
  union {
    struct {
      UINT CpuEventObject : 1;
#if ...
      UINT Reserved : 31;
#else
      UINT Reserved : 32;
#endif
    };
    UINT Flags;
  };
} DXGKARGCB_SIGNALEVENT;

Members

hDxgkProcess

[in] Handle to the Dxgkrnl process object that was passed to DxgkDdiCreateProcess. The process must be created for a virtual machine; that is, DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess must be set in the call to DxgkDdiCreateProcess.

When CpuEventObject is set, hDxgkProcess must be zero.

The driver must synchronize the callback with DxgkDdiDestroyProcess to ensure that the process isn't destroyed during the callback.

hEvent

[in] The user-mode event handle that needs to be signaled. The handle is valid in the context of the Dxgkrnl process identified by hDxgkProcess. The user-mode driver on the guest can send the user-mode event handle to the kernel-mode driver via DxgkddiEscape or other APIs that allow private driver data.

When CpuEventObject is set, hEvent is equal to the Dxgkrnl CPU event object handle, passed in DxgkddiCreatecpuevent.

CpuEventObject

[in] When set, indicates the event is a CPU event object. Supported starting in Windows 11 (WDDM 3.0). See Signaling a CPU event from KMD for more information.

Reserved

[in] Reserved; set to zero.

Flags

[in] An alternative way to access the union's flags.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1809 (WDDM 2.5)
Header d3dkmddi.h

See also

DxgkCbSignalEvent

DxgkddiCreatecpuevent

DxgkDdiCreateProcess

DxgkDdiDestroyProcess

DxgkddiEscape