DXGK_ALLOCATIONINFOFLAGS構造体 (d3dkmddi.h)

[アーティクル]
03/08/2023

DXGK_ALLOCATIONINFOFLAGS構造体は、割り当てのプロパティを識別します。

構文

typedef struct _DXGK_ALLOCATIONINFOFLAGS {
  union {
    struct {
      UINT CpuVisible : 1;
      UINT PermanentSysMem : 1;
      UINT Cached : 1;
      UINT Protected : 1;
      UINT ExistingSysMem : 1;
      UINT ExistingKernelSysMem : 1;
      UINT FromEndOfSegment : 1;
      UINT Swizzled : 1;
      UINT Overlay : 1;
      UINT Capture : 1;
      UINT UseAlternateVA : 1;
      UINT SynchronousPaging : 1;
      UINT LinkMirrored : 1;
      UINT LinkInstanced : 1;
      UINT HistoryBuffer : 1;
      UINT AccessedPhysically : 1;
      UINT ExplicitResidencyNotification : 1;
      UINT HardwareProtected : 1;
      UINT CpuVisibleOnDemand : 1;
      UINT Reserved : 4;
      UINT DXGK_ALLOC_RESERVED16 : 1;
      UINT DXGK_ALLOC_RESERVED15 : 1;
      UINT DXGK_ALLOC_RESERVED14 : 1;
      UINT DXGK_ALLOC_RESERVED13 : 1;
      UINT DXGK_ALLOC_RESERVED12 : 1;
      UINT DXGK_ALLOC_RESERVED11 : 1;
      UINT DXGK_ALLOC_RESERVED10 : 1;
      UINT DXGK_ALLOC_RESERVED9 : 1;
      UINT DXGK_ALLOC_RESERVED4 : 1;
      UINT DXGK_ALLOC_RESERVED3 : 1;
      UINT DXGK_ALLOC_RESERVED2 : 1;
      UINT DXGK_ALLOC_RESERVED1 : 1;
      UINT DXGK_ALLOC_RESERVED0 : 1;
    };
    UINT Value;
  };
} DXGK_ALLOCATIONINFOFLAGS;

メンバー

CpuVisible

[out]割り当てが CPU から直接アクセスできるかどうかを指定する UINT 値。ディスプレイミニポートドライバーは、割り当て時に pfnLockCb 関数を正常に呼び出すために、ユーザーモードディスプレイドライバーのこのフラグを設定する必要があります。このフラグが割り当てに設定されていない場合、 pfnLockCb はエラーを返します。

共有割り当てを作成したプロセスのみが、その割り当てをロックできることに注意してください。

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

PermanentSysMem

[out]コンテンツがメモリセグメント内にある場合でも、割り当てのコピーをシステムメモリに保持するかどうかを指定する UINT 値。既定では、メモリセグメントに割り当てを転送すると、サーフェスシステムのメモリバッキングストアは失われます。 PermanentSysMem フラグが指定され、割り当てがメモリセグメントから削除されると、割り当ての内容は破棄され、割り当てがダーティされていない場合はページングされません (つまり、割り当ては、ページインされてから書き込み操作のターゲットではなかった)。

割り当て時に pfnLockCb を呼び出すと、割り当てのシステムメモリバッキングストアが常に返されます。ユーザーモードディスプレイドライバーが pfnUnlockCb を呼び出すときに割り当てがメモリセグメント内にある場合、割り当てのメモリセグメントリソースは新しいコンテンツで更新されます。この更新プログラムは、 DxgkDdiBuildPagingBuffer 関数を介した通常のページング操作として、ディスプレイミニポートドライバーに表示されます。ディスプレイミニポートドライバーがページング操作の最小領域サイズまたは配置を必要とする場合は、この要件がロックされているリージョンに反映される必要があります。ドライバーが PermanentSysMem を設定する場合、ドライバーは CpuVisible メンバーも設定する必要があります。ドライバーは、プライマリサーフェイスに PermanentSysMem を設定しないでください。

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

Cached

[out]割り当てバッキングストアをキャッシュメモリとして割り当てるかどうかを指定する UINT 値。既定では、割り当てバッキングストアは書き込み結合メモリとして格納されます。キャッシュに一貫性のないセグメント (メモリセグメントや AGP セグメントなど) でキャッシュメモリ割り当てが使用されている場合、ビデオメモリマネージャーは、適切なタイミングでプロセッサのキャッシュからフラッシュすることで、割り当ての内容の一貫性を確保します。

ドライバーが Cached を設定し、 ExistingSysMem または ExistingKernelSysMem メンバーも設定すると、ドライバーは、既存のメモリがキャッシュ可能にマップされたことをビデオメモリマネージャーに示します。既存のメモリがキャッシュ可能にマップされていても、ドライバーが キャッシュされた メンバーの設定に失敗した場合、ビデオメモリマネージャーはデータの一貫性を確保できず、破損が発生します。ドライバーは、アプリケーションまたはユーザーモードのディスプレイドライバーによって読み取られる割り当ての キャッシュ されたメンバーを設定する必要があります。ドライバーは、書き込み専用の割り当てに対して キャッシュされた メンバーを設定しないでください。

ドライバーがこのメンバーを設定する場合、ドライバーは CpuVisible メンバーも設定する必要があります。ドライバーは、プライマリサーフェスに キャッシュを 設定しないでください。

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

Protected

[out]アプリケーションによる潜在的な直接 CPU アクセスから割り当てを保護するために、ユーザーアドレス空間ではなく、割り当てバッキングストアをカーネルメモリに割り当てるかどうかを指定する UINT 値。ドライバーは、PermanentSysMem、ExistingSysMem、または ExistingKernelSysMem メンバーと組み合わせてこのメンバーを設定できません。ドライバーは、プライマリサーフェスで Protected を設定しないでください。

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

ExistingSysMem

[out]ビデオメモリマネージャーが割り当てのバッキングストアとして既存のシステムメモリ範囲を使用するかどうかを指定する UINT 値。システムメモリ範囲は、割り当てのサイズに対する現在のプロセスの有効なユーザーモードアドレスである必要があります。システムメモリの範囲もページアラインされ、サイズが複数のページである必要があります。

システムメモリの範囲がキャッシュ可能な仮想アドレスの場合、ドライバーは、割り当てに対するキャッシュの一貫性を確保するためにビデオメモリマネージャーに通知するように Cached メンバーを設定する必要があります。 Cached メンバーが指定されていない場合、ビデオメモリマネージャーは、システムメモリの範囲がキャッシュ不可能、書き込み結合、またはキャッシュ可能であると判断します。ただし、この状況では、ドライバーはキャッシュの一貫性を確保するか、キャッシュの一貫性が指定された使用の問題ではないことを判断します。

この種類の割り当ては、 PermanentSysMem メンバーが設定されている割り当てと同じロックセマンティクスを暗黙的に持つ点に注意してください。

ドライバーは、PermanentSysMem、Protected、または ExistingKernelSysMem メンバーと組み合わせて ExistingSysMem を設定できません。ドライバーは、プライマリサーフェイスに ExistingSysMem を設定しないでください。

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

ExistingKernelSysMem

[out]ビデオメモリマネージャーが割り当てのバッキングストアとして既存のシステムメモリ範囲を使用するかどうかを指定する UINT 値。システムメモリの範囲は、ページ上に配置され、サイズが複数のページに配置された有効なカーネルモードアドレスである必要があります。

この種類の割り当ては、 PermanentSysMem メンバーが設定されている割り当てと同じロックセマンティクスを暗黙的に持つ点に注意してください。

ドライバーは、PermanentSysMem、Protected、または ExistingSysMem メンバーと組み合わせて ExistingKernelSysMem を設定できません。ドライバーは、プライマリサーフェイスに ExistingKernelSysMem を設定しないでください。

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

FromEndOfSegment

[out]ページング中にセグメントの末尾から割り当てるかどうかを指定する UINT 値。ビデオメモリマネージャーは、セグメントのアドレス空間をスキャンし、セグメントの先頭からスキャンするのではなく、セグメントの末尾からの割り当ての領域を探します (これが既定の動作です)。ただし、ヒントと優先されるセグメント情報は、このフラグよりも優先されます。

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

Swizzled

[out]割り当てがスウィズルされるかどうかを指定する UINT 値。割り当てをロックするには、ビデオメモリマネージャーによる特別なサポートが必要です。スウィズルされた割り当ての詳細については、「スウィズルされた割り当てのロック」を参照してください。

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

Overlay

[out]割り当てがオーバーレイ操作用かどうかを指定する UINT 値。オーバーレイ割り当てはメモリに固定されており、タイムアウト検出と回復 (TDR) プロセス、プラグアンドプレイ (PnP) の停止、またはレベル 3 の同期が発生しない限り、ビデオメモリマネージャーはそれらを削除できません。レベル 3 の同期が発生する前に、オーバーレイは通常破棄されることに注意してください。既定では、オーバーレイ割り当ては制限されており、セグメントの最後の 20% を超えることはできません。オーバーレイ割り当てが絞りセグメントに割り当てられている場合、ディスプレイミニポートドライバーは、そのアパーチャセグメントを削除セグメントとして使用する他の割り当てのサイズをセグメントサイズの 80% に制限する必要があります。ディスプレイミニポートドライバーは、割り当てにDXGK_ALLOCATIONINFO構造体のEvictionSegmentSet メンバー内のセグメントの適切なビットを指定することによって、割り当てで削除にセグメントを使用できることを示します。ディスプレイミニポートドライバーが別の割り当てのサイズを制限しない場合、固定された割り当て (つまり、オーバーレイの割り当て) が削除に必要な領域を占有するため、ビデオメモリマネージャーはセグメントを介してその割り当てを削除できません。この場合、削除される他の割り当ての内容が失われ、失われた割り当てを所有するアプリケーションは、その割り当てでレンダリングできなくなります。

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

Capture

[out]割り当てがキャプチャ操作に使用されるかどうかを示す UINT 値。キャプチャ割り当ては、オーバーレイ割り当てと同様にメモリに固定されます。そのため、オーバーレイ割り当てに適用される問題は、割り当てのキャプチャにも適用されます。これらの問題の詳細については、 オーバーレイ フラグの説明を参照してください。レベル 3 の同期が発生する前に、キャプチャは通常停止されることに注意してください。

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

UseAlternateVA

[out]1 次割り振りをロックできるかどうかを指定する UINT 値。 UseAlternateVA は、プライマリ割り当てに対してのみ有効です。他の割り当てに UseAlternateVA を指定した場合、割り当ては作成されません。 UseAlternateVA を使用してプライマリ割り当てが作成されると、割り当ての作成時にプライマリ割り当ての範囲が設定されます。

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

SynchronousPaging

[out]割り当てを同期的にページングするかどうかを指定する UINT 値。ディスプレイミニポートドライバーがこのビットを割り当てに設定すると、ビデオメモリマネージャーは、割り当てがビジー状態でなくなるまで待機します (つまり、ビデオメモリマネージャーは、グラフィックス処理装置 (GPU) が割り当てを参照するすべてのフェンスを報告するまで待機します)。ビデオメモリマネージャーは、割り当てを参照するページングバッファーを送信します。

同様に、ビデオメモリマネージャーは、ビデオメモリマネージャーが非ページングダイレクトメモリアクセス (DMA) バッファーを送信する前に、同期割り当てのページング操作が完了するまで待機します。

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

LinkMirrored

[out]論理アダプター内のすべての物理アダプター (つまり、リンク) に割り当ての 1 つのインスタンスをレプリケートするかどうかを指定する UINT 値。ビデオメモリマネージャーは、ドライバーを呼び出してページインし、システムメモリ内の 1 つの共有バッキングストアを持つすべての物理アダプターの割り当てを削除します。

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

LinkInstanced

[out]割り当ての異なるインスタンスを、論理アダプター内のすべての物理アダプター (つまりリンク) にページングして削除するかどうかを指定する UINT 値。論理アダプター内の物理アダプターごとに 1 つのシステムメモリバッキングストアが存在します。

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

HistoryBuffer

[out]ユーザーモード表示ドライバーが履歴バッファーを割り当てるかどうかを指定する UINT 値。ディスプレイミニポートドライバーは、ユーザーモードドライバーが履歴バッファーの作成と破棄を管理できることを示すために、このフラグを設定する必要があります。

ディスプレイミニポートドライバーが HistoryBuffer を設定する場合は、 CpuVisible フラグも設定する必要があります。ドライバーがキャッシュコヒーレント絞りセグメントをサポートしている場合は、 Cached も設定し、他のすべてのメンバーを 0 に設定する必要があります。

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

Windows 8.1 以降でサポートされます。

AccessedPhysically

カーネルモードドライバーは、物理アドレスによってアクセスされる割り当てにフラグを設定します。このような割り当ては、GPU メモリセグメントから連続して割り当てられます。システムメモリから割り当てられた場合、割り当ては連続しません。

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

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

ExplicitResidencyNotification

このフラグを指定すると、ドライバーは割り当て場所が変更されたときに NotifyResidency ページングバッファー操作を受け取ります (削除、コミット)。フラグは、 AccessedPhysically フラグが設定されている場合にのみ設定できます。

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

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

HardwareProtected

このメンバーを設定すると、割り当てには、ハードウェアデジタル著作権管理 (DRM) に使用されるコンテンツが保持されます。

CpuVisibleOnDemand

このメンバーを設定すると、ビデオメモリマネージャーは、割り当て時に割り当てに仮想アドレスを割り当てようとします。これにより、割り当てに永続的な仮想アドレスが割り当てられないため、使用される仮想アドレス空間の量が減ります。 CPU によって直接アクセス可能な割り当てであるという点で、 CpuVisible フラグと同様に動作しますが、永続的に割り当てられるのではなく、"オンデマンド" の仮想アドレスを取得するだけです。

Reserved

システムで使用するために予約されています。 Windows 10 以降で使用できます。

DXGK_ALLOC_RESERVED16