DXGKCB_CREATECONTEXTALLOCATION コールバック関数 (d3dkmddi.h)

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

DXGKCB_CREATECONTEXTALLOCATION は、GPU コンテキストまたはデバイス固有のコンテキストを割り当てます。

構文

DXGKCB_CREATECONTEXTALLOCATION DxgkcbCreatecontextallocation;

NTSTATUS DxgkcbCreatecontextallocation(
  [in/out] INOUT_PDXGKARGCB_CREATECONTEXTALLOCATION unnamedParam1
)
{...}

パラメーター

[in/out] unnamedParam1

割り当てるコンテキストの属性を指定する DXGKARGCB_CREATECONTEXTALLOCATION 構造体へのポインター。

戻り値

成功した 場合、DXGKCB_CREATECONTEXTALLOCATION はSTATUS_SUCCESS を返します。それ以外の場合は、 Ntstatus.h で定義されているエラーコードのいずれかを返します。

注釈

WDDM 1.2 以降では、ディスプレイミニポートドライバーは、GPU 固有のコンテキスト (GPU コンテキストの割り当て) またはデバイス固有のコンテキスト (デバイスコンテキストの割り当て) を割り当てることができます。

GPU コンテキスト割り当てにより、GPU は、実行中に割り込まれた DMA バッファーからのコンテキスト状態を格納できます。ドライバーは、必要なときに状態を保存するために、GPU コンテキストに関連付けられた割り当てを作成します。オペレーティングシステムは、このコンテキストからのコマンドが GPU のハードウェア実行キューに配置される前に、コンテキスト割り当てが常駐していることを確認します。コンテキストは、別のコンテキストからのコマンドがハードウェア実行キューに配置されるまで常駐します。

さらに、オペレーティングシステムでは、コンテキストに属するコマンドを完了した後、ハードウェアコンテキストの状態が GPU で保持されていると仮定することで、遅延 GPU コンテキストの切り替えをサポートしています。この方法では、別のコンテキストからのコマンドがハードウェアキューに送信された場合にのみ、コンテキストが GPU で切り替わります。

DXGKCB_XXX 関数は Dxgkrnl によって実装されます。このコールバック関数を使用するには、DXGKARGCB_ALLOCATEPAGESFORMDLのメンバーを設定し、DXGKRNL_INTERFACEを介して DxgkCbCreateContextAllocation を呼び出します。

GPU コンテキストの割り当て

GPU コンテキストの割り当ては、システム以外のコンテキストに対してのみ行うことができます。ディスプレイミニポートドライバーは、 DxgkDdiCreateContext を呼び出すことによって、これらのコンテキストを作成します。非システムコンテキストを作成するために、ドライバーは、DXGK_CREATECONTEXTFLAGS構造体の SystemContext メンバーを 0 に設定し、pCreateContext パラメーターでこの構造体へのポインターを渡します。

デバイスコンテキストの割り当ては同様のモデルに従います。ただし、関連付けられているデバイスに属するすべてのコンテキストに対して維持される点が除きます。このモデルを使用すると、ドライバーは GPU コンテキストの割り当てを使用して GPU コンテキスト保存領域 (CSA) データを格納し、ページテーブルデータを格納するためにデバイスコンテキスト割り当てを使用できます。

デバイスコンテキストの割り当て

デバイスコンテキストの割り当ては、システム以外のデバイスに対してのみ行うことができます。ディスプレイミニポートドライバーは 、DxgkDdiCreateDevice を呼び出すことによって、これらのデバイスを作成します。システム以外のデバイスを作成するために、ドライバーは、DXGK_CREATEDEVICEFLAGS構造体の Flags.SystemDevice メンバーを 0 に設定し、pCreateDevice パラメーターでこの構造体へのポインターを渡します。

ディスプレイミニポートドライバーは、DxgkCbCreateContextAllocation を介して割り当てられたコンテキストリソースを解放するために、DXGKCB_DESTROYCONTEXTALLOCATIONを呼び出します。

宛先コンテキスト割り当ての仮想アドレス

オペレーティングシステムがターゲットコンテキスト割り当て (DXGKARG_BUILDPAGINGBUFFER 構造体の InitContextResource-Destination-VirtualAddress>> メンバー) の有効な (NULL 以外の) 仮想アドレスを確実に設定するには、ディスプレイミニポートドライバーが DxgkCbCreateContextAllocation を呼び出すときに、次の操作を行う必要があります。

DXGK_ALLOCATIONINFOFLAGS構造体の CpuVisible メンバーと Protected メンバーを設定します。
DXGKARGCB_CREATECONTEXTALLOCATION構造体の SupportedSegmentSet メンバーを設定して、絞りセグメントのみに割り当てるページ。

要件

要件	値
サポートされている最小のクライアント	Windows 8 (WDDM 1.2)
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL