D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS 構造体 (d3dukmdt.h)

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

D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS構造体は、同期オブジェクトの属性を識別します。

構文

typedef struct _D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS {
  union {
    struct {
      UINT Shared : 1;
      UINT NtSecuritySharing : 1;
      UINT CrossAdapter : 1;
      UINT TopOfPipeline : 1;
      UINT NoSignal : 1;
      UINT NoWait : 1;
      UINT NoSignalMaxValueOnTdr : 1;
      UINT NoGPUAccess : 1;
      UINT SignalByKmd : 1;
      UINT Unused : 1;
      UINT UnwaitCpuWaitersOnlyOnDestroy : 1;
#if ...
      UINT Reserved : 20;
#elif
      UINT Reserved : 21;
#elif
      UINT Reserved : 22;
#elif
      UINT Reserved : 23;
#elif
      UINT Reserved : 28;
#else
      UINT Reserved : 29;
#endif
      UINT D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS_RESERVED0 : 1;
    };
    UINT Value;
  };
} D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS;

メンバー

Shared

同期オブジェクトを共有するかどうかを指定する UINT 値。

Shared が 1 (TRUE) に設定されている場合、同期オブジェクトは共有されます。 Shared が 0 (FALSE) に設定されている場合、同期オブジェクトは共有されません。詳細については、「解説」を参照してください。

NtSecuritySharing

同期オブジェクトを NT ハンドルと共有するかどうかを指定する UINT 値。つまり、リソースに対するグローバル D3DKMT_HANDLE カーネルモードハンドルがないことを意味します。

NtSecuritySharing が 1 (TRUE) に設定されている場合、同期オブジェクトは共有されますが、リソースへのグローバル D3DKMT_HANDLE ハンドルはありません。

注意

NtSecuritySharing が 1 に設定されている場合は、Shared を 1 に設定する必要があります。詳細については、「解説」を参照してください。

Windows 8 以降でサポートされています。

CrossAdapter

同期オブジェクトがハイブリッドシステム上の共有アダプター間リソースオブジェクトであるかどうかを示す UINT 値。

CrossAdapter が 1 (TRUE) に設定されている場合、同期オブジェクトは共有クロスアダプターオブジェクトです。 CrossAdapter が 0 (FALSE) に設定されている場合、同期オブジェクトは共有クロスアダプターオブジェクトではありません。

TopOfPipeline

値	意味
TRUE	同期オブジェクトの前のコマンドバッファーの内容が GPU パイプラインに完全にコピーされるとすぐに通知するかどうかを指定しますが、必ずしも実行が完了したとは限りません。この動作により、コマンドバッファーをできるだけ早く再利用できます。
FALSE	同期オブジェクトは、上記のコマンドバッファーの実行が完了した後に通知されます。

この値は、監視対象のフェンス同期オブジェクトの場合は 1 (TRUE) にのみ設定でき、他のすべての同期オブジェクトの種類では 0 (FALSE) に設定する必要があります。

Windows 10 以降でサポートされています。

NoSignal

値	意味
TRUE	この同期オブジェクトが作成または開かれたデバイスで、待機コマンドのみを送信できることを指定します。このフラグが設定されているときにシグナル操作を送信しようとすると、STATUS_ACCESS_DENIEDが返されます。
FALSE	同期オブジェクトはシグナル通知を受け取ることができます。

Windows 10 以降でサポートされています。

NoWait

値	意味
TRUE	この同期オブジェクトが作成または開かれたデバイスが、シグナルコマンドのみを送信できることを指定します。このフラグが設定されているときに待機操作を送信しようとすると、STATUS_ACCESS_DENIEDが返されます。
FALSE	同期オブジェクトは待機できます。

このフラグを NoSignal フラグと同時に設定することはできません。

Windows 10 以降でサポートされています。

NoSignalMaxValueOnTdr

値	意味
TRUE	TDR の場合、監視対象フェンスの前述のシグナリングを最大値にバイパスするように GPU スケジューラに指示します。
FALSE	GPU スケジューラは、GPU リセット (TDR) の影響を受ける可能性があるデバイスが通知する可能性がある場合に、監視対象のフェンスに最大値を通知します。

Windows 10 以降でサポートされています。

NoGPUAccess

設定すると、フェンスは GPU 仮想アドレス空間にマップされず、(アダプターキャップに関係なく) 常に 64 ビット値として格納されます。パケットベースのシグナル/待機操作のみがサポートされます。 Windows 10 以降でサポートされています。

SignalByKmd

設定すると、カーネルモードドライバー (KMD) によってフェンスを通知できます。このフラグは、 D3DDDI_CPU_NOTIFICATION オブジェクトでのみ使用できます。 Windows 11 (WDDM 3.0) 以降でサポートされています。

Unused

このメンバーは使用されておらず、0 に設定する必要があります。 Windows 11 バージョン 22H2 (WDDM 3.1) 以降で使用できます。

UnwaitCpuWaitersOnlyOnDestroy

設定すると、CPU 上の共有同期オブジェクトのウェイターは、共有同期オブジェクトが最終的に破棄されたときにのみブロック解除されます。既定では、ローカル同期オブジェクトが破棄されると CPU ウェイターのブロックが解除されますが、メイン共有同期オブジェクトは別のローカル同期オブジェクトによって開かれます。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

Reserved

このメンバーは予約されており、0 に設定する必要があります。

D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS_RESERVED0

このメンバーは予約されており、0 に設定する必要があります。

Windows 8 以降でサポートされています。

Value

同期オブジェクトの属性を識別する 1 つの 32 ビット値を保持できる 、D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS に含まれる共用体内のメンバー。

注釈

D3DKMTShareObjects 関数を使用して共有するオブジェクトは、まず NtSecuritySharing フラグ値を設定して作成する必要があります。このフラグ値は、 D3DKMT_CREATEALLOCATIONFLAGS、 D3DKMT_CREATEKEYEDMUTEX2_FLAGS、 およびD3DDDI_SYNCHRONIZATIONOBJECT_FLAGS 構造体で使用できます。

ドライバーは、 D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS フラグに関する次のガイドラインに従う必要があります。

同期オブジェクトが共有されていない場合は、 Shared と NtSecuritySharing の両方を 0 に設定します。
同期オブジェクトが D3DKMT_HANDLE データ型と共有されている場合は、 Shared = 1 と NtSecuritySharing = 0 を設定します。
同期オブジェクトがプロセスへの NT ハンドルと共有されている場合 (およびリソースへのグローバル D3DKMT_HANDLE カーネルモードハンドルがない場合)、 Shared = 1 と NtSecuritySharing = 1 を設定します。