DXGKARGCB_SIGNALEVENT-Struktur (d3dkmddi.h)

Artikel
02/26/2024

DXGKARGCB_SIGNALEVENT enthält die Argumente, die von der DXGKCB_SIGNALEVENT 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;

Member

hDxgkProcess

[in] Handle an das DXGK-Prozessobjekt, das an DxgkDdiCreateProcess übergeben wird. Der Prozess muss für einen virtuellen Computer erstellt werden, auf dem DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess in DxgkDdiCreateProcess festgelegt ist.

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 im Benutzermodus, das signalisiert werden muss. Das Handle ist im Kontext des DXGK-Prozesses gültig, der durch hDxgkProcess identifiziert wird. Der Benutzermodustreiber auf dem Gast kann das Benutzermodusereignishandle über DXGKDDI_ESCAPE oder andere APIs, die private Treiberdaten zulassen, an den Kernelmodustreiber senden.

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

CpuEventObject

[in] Wenn festgelegt, gibt an, dass das Ereignis ein CPU-Ereignisobjekt ist. Unterstützt ab Windows 11 (WDDM 3.0). Weitere Informationen finden Sie unter Signalisieren eines CPU-Ereignisses von KMD .

Reserved

[in] Reserviert; auf 0 (null) festgelegt.

Flags

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