D3DDDI_ALLOCATIONLIST 構造体 (d3dukmdt.h)

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

D3DDDI_ALLOCATIONLIST構造体は、ダイレクトメモリアクセス (DMA) バッファリングで使用される割り当て仕様に関する情報を記述します。

構文

typedef struct _D3DDDI_ALLOCATIONLIST {
  D3DKMT_HANDLE hAllocation;
  union {
    struct {
      UINT WriteOperation : 1;
      UINT DoNotRetireInstance : 1;
      UINT OfferPriority : 3;
#if ...
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    UINT Value;
  };
} D3DDDI_ALLOCATIONLIST;

メンバー

hAllocation

[入力]D3DDDI_OPENALLOCATIONINFO構造体の hAllocation メンバーの D3DKMTOpenResource 関数、またはD3DDDI_ALLOCATIONINFO構造体の hAllocation メンバーの D3DKMTCreateAllocation 関数によって返される割り当てハンドル。

WriteOperation

[入力]割り当てを書き込むことができるかどうかに関する情報を保持できる UINT。を 1 に設定すると、割り当てを書き込むことができます。

このメンバーの設定は、32 ビット Value メンバーの最初のビット (0x00000001) を設定することと同じです。

DoNotRetireInstance

[入力]割り当てを廃止できるかどうかに関する情報を保持できる UINT。 1 に設定すると、ドライバーは後続の DMA バッファー (たとえば、複数のコンテキストへの DMA バッファーの手動ブロードキャスト) で再び参照するため、ビデオメモリマネージャーが割り当てのインスタンスを削除しないことを示します。割り当てのすべてのインスタンスは、最終的に廃止されます。このフラグはほとんど使用しません。

このメンバーの設定は、32 ビット Value メンバー (0x00000002) の 2 番目のビットを設定することと同じです。

OfferPriority

[入力]ユーザーモードディスプレイドライバーが再利用のために提供するビデオメモリリソースの重要性を示す、 D3DDDI_OFFER_PRIORITY 列挙からの値。

OfferPriority の値が D3DDDI_OFFER_PRIORITY_NONE でない場合、割り当ては DMA バッファーの処理後に提供されると見なされます。

このメンバーの設定は、32 ビット Value メンバー (0x0000001C) のビット 3 から 5 を設定することと同じです。

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

Reserved

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

Value

[入力]DMA バッファリングで使用される割り当て仕様に関する情報を識別する 32 ビット値。