estrutura DXGKARGCB_SIGNALEVENT (d3dkmddi.h)

Artigo
02/23/2024

DXGKARGCB_SIGNALEVENT contém os argumentos usados pela função de retorno de chamada DXGKCB_SIGNALEVENT para sinalizar um evento.

Sintaxe

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;

Membros

hDxgkProcess

[in] Manipule para o objeto de processo DXGK que é passado para DxgkDdiCreateProcess. O processo deve ser criado para uma máquina virtual, em que DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess é definido em DxgkDdiCreateProcess.

Quando CpuEventObject está definido, hDxgkProcess deve ser zero.

O driver deve sincronizar o retorno de chamada com DxgkDdiDestroyProcess para garantir que o processo não seja destruído durante o retorno de chamada.

hEvent

[in] O identificador de evento do modo de usuário que precisa ser sinalizado. O identificador é válido no contexto do processo DXGK, identificado por hDxgkProcess. O driver do modo de usuário no convidado pode enviar o identificador de evento do modo de usuário para o driver do modo kernel por meio de DXGKDDI_ESCAPE ou outras APIs que permitem dados de driver privado.

Quando CpuEventObject é definido, hEvent é igual ao identificador de objeto de evento da CPU Dxgkrnl , passado em DXGKDDI_CREATECPUEVENT.

CpuEventObject

[in] Quando definido, indica que o evento é um objeto de evento da CPU. Com suporte a partir de Windows 11 (WDDM 3.0). Consulte Sinalizando um evento de CPU do KMD para obter mais informações.

Reserved

[in] Reservados; definido como zero.

Flags

[in] Uma maneira alternativa de acessar os sinalizadores do sindicato.