DXGKARGCB_SIGNALEVENT 構造体 (d3dkmddi.h)

[アーティクル]
02/23/2024

DXGKARGCB_SIGNALEVENT には、イベントを通知するために DXGKCB_SIGNALEVENT コールバック関数によって使用される引数が含まれています。

構文

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

[入力] DxgkDdiCreateProcess に渡される DXGK プロセスオブジェクトを処理します。このプロセスは、 DxgkDdiCreateProcess で DXGK_CREATEPROCESSFLAGS::VirtualMachineProcess が設定されている仮想マシン用に作成する必要があります。

CpuEventObject が設定されている場合、hDxgkProcess は 0 である必要があります。

ドライバーは、コールバック中にプロセスが破棄されないように、コールバックを DxgkDdiDestroyProcess と同期する必要があります。

hEvent

[入力]通知する必要があるユーザーモードイベントハンドル。ハンドルは、 hDxgkProcess によって識別される DXGK プロセスのコンテキストで有効です。ゲストのユーザーモードドライバーは、プライベートドライバーデータを許可する DXGKDDI_ESCAPE またはその他の API を介して、ユーザーモードイベントハンドルをカーネルモードドライバーに送信できます。

CpuEventObject が設定されている場合、hEvent は、DXGKDDI_CREATECPUEVENTで渡される Dxgkrnl CPU イベントオブジェクトハンドルと等しくなります。

CpuEventObject

[入力]設定すると、は、イベントが CPU イベントオブジェクトであることを示します。 Windows 11 (WDDM 3.0) 以降でサポートされています。詳細については、「 KMD からの CPU イベントのシグナル化」を参照してください。

Reserved

[入力]予約;を 0 に設定します。

Flags

[入力]共用体のフラグにアクセスする別の方法。