DXGKARGCB_SIGNALEVENT Struktur (d3dkmddi.h)

Artikel
02/09/2025

DXGKARGCB_SIGNALEVENT enthält die Argumente, die vom DxgkCbSignalEvent Rückruffunktion verwendet werden, um ein Ereignis zu signalisieren.

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;

Angehörige

hDxgkProcess

[in] Handle to the Dxgkrnl process object that was passed to DxgkDdiCreateProcess. Der Prozess muss für einen virtuellen Computer erstellt werden; d. h. DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess muss im Aufruf von DxgkDdiCreateProcessfestgelegt werden.

Wenn CpuEventObject- festgelegt ist, muss hDxgkProcess- null sein.

Der Treiber muss den Rückruf mit DxgkDdiDestroyProcess synchronisieren, um sicherzustellen, dass der Prozess während des Rückrufs nicht zerstört wird.

hEvent

[in] Das Ereignishandle für den Benutzermodus, das signalisiert werden muss. Das Handle ist im Kontext des Dxgkrnl- Prozesses gültig, der durch hDxgkProcess-identifiziert wird. Der Benutzermodustreiber auf dem Gast kann den Benutzermodusereignishandle über DxgkddiEscape- oder andere APIs, die private Treiberdaten zulassen, an den Kernelmodustreiber senden.

Wenn CpuEventObject- festgelegt wird, entspricht hEvent- dem Dxgkrnl CPU-Ereignisobjekthandle, das in DxgkddiCreatecpueventübergeben wird.

CpuEventObject

[in] Gibt an, dass es sich bei dem Ereignis um ein CPU-Ereignisobjekt handelt. Wird ab Windows 11 (WDDM 3.0) unterstützt. Weitere Informationen finden Sie unter Signaling a CPU event from KMD.

Reserved

[in] Reserviert; auf Null festgelegt.

Flags

[in] Eine alternative Möglichkeit, auf die Flaggen der Union zuzugreifen.