DXGK_SEGMENTBANKPREFERENCE構造体 (d3dkmddi.h)

[アーティクル]
05/26/2023

DXGK_SEGMENTBANKPREFERENCE構造体では、割り当てでのページングに関する銀行の設定について説明します。

構文

typedef struct _DXGK_SEGMENTBANKPREFERENCE {
  union {
    struct {
      UINT Bank0 : 7;
      UINT Direction0 : 1;
      UINT Bank1 : 7;
      UINT Direction1 : 1;
      UINT Bank2 : 7;
      UINT Direction2 : 1;
      UINT Bank3 : 7;
      UINT Direction3 : 1;
    };
    [out] UINT Value;
  };
} DXGK_SEGMENTBANKPREFERENCE;

メンバー

[out] Bank0

優先度が最も高い優先銀行の識別子。優先設定が必要ない場合は 0。有効な値は 1 から 127 です。

このメンバーは、32 ビット Value メンバーの最初の 7 ビット (0x0000007F) と同じです。

[out] Direction0

メモリの空き領域を見つけるために Bank0 をスキャンする方向。値 0 は、ボトムアップ検索 (つまり、低アドレスから高いアドレス) を示し、値 1 は上から下の検索 (つまり、高いアドレスから低いアドレス) を示します。

このメンバーは、32 ビット Value メンバー (0x00000080) の 8 番目のビットと同じです。

[out] Bank1

優先度が最も高い次の優先バンクの識別子。優先設定が不要な場合は 0。有効な値は 1 から 127 です。

このメンバーは、32 ビット Value メンバー (0x00007F00) のビット 9 から 15 に相当します。

[out] Direction1

メモリの空き穴を見つけるために Bank1 をスキャンする方向。値 0 は、ボトムアップ検索 (つまり、低アドレスから高いアドレス) を示し、値 1 は上から下の検索 (つまり、高いアドレスから低いアドレス) を示します。

このメンバーは、32 ビット Value メンバー (0x00008000) の 16 番目のビットに相当します。

[out] Bank2

優先度が最も高い次の優先バンクの識別子。優先設定が不要な場合は 0。有効な値は 1 から 127 です。

このメンバーは、32 ビット Value メンバー (0x007F0000) のビット 17 から 23 に相当します。

[out] Direction2

メモリの空き穴を見つけるために Bank2 をスキャンする方向。値 0 は、ボトムアップ検索 (つまり、低アドレスから高いアドレス) を示し、値 1 は上から下の検索 (つまり、高いアドレスから低いアドレス) を示します。

このメンバーは、32 ビット Value メンバー (0x00800000) の 24 番目のビットに相当します。

[out] Bank3

優先度が最も高い次の優先バンクの識別子。優先設定が不要な場合は 0。有効な値は 1 から 127 です。

このメンバーは、32 ビット Value メンバー (0x7F000000) のビット 25 から 31 に相当します。

[out] Direction3

メモリの空き穴を見つけるために Bank3 をスキャンする方向。値 0 は、ボトムアップ検索 (つまり、低アドレスから高いアドレス) を示し、値 1 は上から下の検索 (つまり、高いアドレスから低いアドレス) を示します。

このメンバーは、32 ビット Value メンバー (0x80000000) の 32 秒ビットに相当します。

[out] Value

銀行の設定を識別する 32 ビット値を保持できる、DXGK_SEGMENTBANKPREFERENCEに含まれる共用体内のメンバー。

注釈

ディスプレイミニポートドライバーは、ドライバーの DxgkDdiCreateAllocation 関数が呼び出されたときに、DXGK_ALLOCATIONINFO構造体の HintedBank メンバーで最大 4 つの銀行設定を示すことができます。優先銀行識別子は 1 から始まります (つまり、最初の銀行の識別子は 1 です)。 0 の識別子は、ドライバーに優先設定がないことを示します。最も優先度の高い優先順位は Bank0 メンバーで指定されます。最も優先度の低い優先順位が Bank3 メンバーで指定されています。ドライバーは、銀行識別子の優先順位の低い設定を 0 に設定することで、4 つ未満の基本設定を指定できます。たとえば、ドライバーは、 Bank0 と Bank1 を有効な識別子に設定し、 Bank2 と Bank3 を 0 に設定することで、2 つの基本設定を指定できます。ドライバーは、各方向X メンバーを使用して、銀行の好みごとにスキャン方向を個別に指定できます。

ビデオメモリマネージャーは、DXGK_ALLOCATIONINFO の PreferredSegment メンバーが指定する優先 セグメントからリソースを割り当てます。