структура DXGKARGCB_SIGNALEVENT (d3dkmddi.h)

Статья
02/08/2025

DXGKARGCB_SIGNALEVENT содержит аргументы, используемые функцией обратного вызова DxgkCbSignalEvent для сигнала о событии.

Синтаксис

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;

Члены

hDxgkProcess

[in] Обработка объекта процесса Dxgkrnl, переданного DxgkDdiCreateProcess. Процесс должен быть создан для виртуальной машины; то есть DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess необходимо задать в вызове DxgkDdiCreateProcess.

Если задан CpuEventObject, hDxgkProcess должно быть равно нулю.

Драйвер должен синхронизировать обратный вызов с DxgkDdiDeprocess, чтобы гарантировать, что процесс не уничтожен во время обратного вызова.

hEvent

[in] Дескриптор событий в режиме пользователя, который должен быть сигналирован. Дескриптор действителен в контексте процесса Dxgkrnl, определяемого hDxgkProcess. Драйвер пользовательского режима на гость может отправлять дескриптор событий пользовательского режима драйверу режима ядра через DxgkddiEscape или другие API, которые позволяют данным частного драйвера.

Если задан CpuEventObject, hEvent равно дескриптору объекта событий ЦП Dxgkrnl, передаваемой в DxgkddiCreatecpuevent.

CpuEventObject

[in] При установке указывает, что событие является объектом события ЦП. Поддерживается начиная с Windows 11 (WDDM 3.0). Дополнительные сведения см. в статье Сигнал о событии ЦП из KMD.

Reserved

[in] Скрытный; установите значение нулю.

Flags

[in] Альтернативный способ доступа к флагам профсоюза.