struttura DXGKARGCB_SIGNALEVENT (d3dkmddi.h)

Articolo
02/08/2025

DXGKARGCB_SIGNALEVENT contiene gli argomenti usati dal DxgkCbSignalEvent funzione di callback per segnalare un evento.

Sintassi

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;

Membri

hDxgkProcess

[in] Handle per l'oggetto processo dxgkrnl passato a DxgkDdiCreateProcess. Il processo deve essere creato per una macchina virtuale; ovvero DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess deve essere impostato nella chiamata a DxgkDdiCreateProcess.

Quando è impostato CpuEventObject, hDxgkProcess deve essere zero.

Il driver deve sincronizzare il callback con DxgkDdiDestroyProcess per assicurarsi che il processo non venga eliminato definitivamente durante il callback.

hEvent

[in] Handle di eventi in modalità utente che deve essere segnalato. L'handle è valido nel contesto del processo Dxgkrnl identificato da hDxgkProcess. Il driver in modalità utente sul guest può inviare l'handle di eventi in modalità utente al driver in modalità kernel tramite DxgkddiEscape o altre API che consentono dati del driver privato.

Quando è impostato CpuEventObject, hEvent è uguale all'handle dell 'oggetto evento dxgkrnl della CPU, passato in DxgkddiCreatecpuevent.

CpuEventObject

[in] Se impostato, indica che l'evento è un oggetto evento CPU. Supportato a partire da Windows 11 (WDDM 3.0). Per altre informazioni, vedere Segnalazione di un evento cpu da KMD.

Reserved

[in] Riservato; impostato su zero.

Flags

[in] Un modo alternativo per accedere alle bandiere dell'unione.