PFND3DDDI_CREATERESOURCE2 コールバック関数 (d3dumddi.h)

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

リソースを作成します。 Windows ディスプレイドライバーモデル (WDDM) 1.2 以降のユーザーモードディスプレイドライバーによって実装されます。

構文

PFND3DDDI_CREATERESOURCE2 Pfnd3dddiCreateresource2;

HRESULT Pfnd3dddiCreateresource2(
  [in] HANDLE hDevice,
       D3DDDIARG_CREATERESOURCE2 *unnamedParam2
)
{...}

パラメーター

[in] hDevice

リソースの作成に使用されるディスプレイデバイス (グラフィックスコンテキスト) へのハンドル。

unnamedParam2

pResource2 [in, out]

作成されるリソースを記述する D3DDDIARG_CREATERESOURCE2 構造体へのポインター。

戻り値

S_OKまたは適切なエラー結果を返します。 WDDM 1.3 以降の Direct3D レベル 9 ドライバーは、次のエラーコードを返す必要があります。

リターンコード	説明
E_INVALIDARG	D3DDDIARG_CREATERESOURCE2。Flagsmember には CaptureBuffer フラグ値が設定されており、リソースがドライバーでサポートできる値を超えています。

注釈

CreateResource2 の呼び出しには、サーフェスの一覧を含めることができます。 pResource2 パラメーターで指定されたD3DDDIARG_CREATERESOURCE2構造体の SurfCount メンバーは、作成するサーフェスの数 (MIP マップレベルを含む) を指定します。たとえば、256 x 256x9 テクスチャ MIP マップリソースには、 SurfCount メンバーと MIP マップレベルの数の両方が 9 に設定されている 9 つのサーフェスのリストが含まれています。 9 つの MIP マップレベルを含むキューブマップでは、MIP マップレベルの数を 9 に設定し、 SurfCount を 54 に設定する必要があります。 3 サーフェススワップチェーンでは 、SurfCount を 3 に設定し、MIP マップレベルの数を 0 に設定する必要があります。 MIP マップレベルの数は、常に SurfCount の値以下であることに注意してください。

CreateResource2 呼び出しに応答して、ユーザーモードディスプレイドライバーは pfnAllocateCb 関数を呼び出して、1 つ以上のメモリ割り当てを作成できます。ユーザーモードディスプレイドライバーは、サーフェスごとに複数の割り当てを作成するか、すべてのサーフェスに対して 1 つの割り当てを作成するか、またはサーフェスごとに 1 つの割り当てを作成する必要があるかを判断する必要があります。割り当ての詳細については、「ビデオメモリ管理と GPU スケジュール」を参照してください。

メモドライバーの CreateResource2 関数は、を返す前に pfnAllocateCb を呼び出す必要はありません。代わりに、ドライバーは割り当ての作成を延期できます。

メモリソースを共有できるのは、リソースのすべての割り当てが pfnAllocateCb の 1 回の呼び出しでアトミックに行われる場合のみです。

D3DDDIARG_CREATERESOURCE2構造体の hResource メンバーは、リソースを識別するために使用されるハンドルです。ユーザーモードのディスプレイドライバーは、 CreateResource2 呼び出しで渡された hResource の値を格納し、 CreateResource2 呼び出しが返されるときに Microsoft Direct3D ランタイムが使用できる別の値で値を上書きする必要があります。つまり、ランタイムの呼び出しでは、ユーザーモードのディスプレイドライバーは、CreateResource2 に渡された hResource 値を使用します。ユーザーモードディスプレイドライバーの呼び出し (SetTexture 関数や SetStreamSource 関数の呼び出しなど) では、ランタイムは CreateResource2 から返された hResource 値を使用します。各サーフェスには明示的なハンドルは含まれていないことに注意してください。サーフェスを個別に参照する必要がある場合 ( Blt 関数の呼び出しなど)、ハンドルとインデックスによって参照されます。インデックスは、リソース内のサーフェスを識別します。インデックスは、D3DDDIARG_CREATERESOURCE2の pSurfList メンバーに含まれる配列 内のサーフェスのインデックスと同じです。

リソースは、複数のデバイス (hDevice) とプロセスで共有できます。ランタイムは、D3DDDIARG_CREATERESOURCE2の Flags メンバーで SharedResource ビットフィールドフラグを設定することで、リソースを共有することを指定します。このビットフィールドフラグが設定されている場合、ユーザーモードディスプレイドライバーは、共有リソースに対する次の制限に従う必要があります。

ユーザーモードのディスプレイドライバーは、それぞれ 1 回だけ pfnAllocateCb 関数と pfnDeallocateCb 関数を呼び出すことができます。
ユーザーモードのディスプレイドライバーは、リソースが最初に作成された後にリソースの追加の割り当てを作成することはできません。同様に、リソース自体が破棄された時点でのみリソース割り当てを破棄できます。
ドライバーの CreateResource2 または OpenResource 関数の呼び出しによって作成または開かれた共有リソースに対してユーザーモードディスプレイドライバーの DestroyResource 関数が呼び出されると、ドライバーは、リソースを破棄または閉じるには、D3DDDICB_DEALLOCATE構造体の hResource メンバーを null 以外に設定し、D3DDDICB_DEALLOCATEのNumAllocations メンバーを 0 に設定する必要があります。つまり、共有リソースに関連付けられている割り当てを個別に破棄したり閉じたりすることはできません。リソースは、 pfnDeallocateCb の 1 回の呼び出しで破棄またはアトミックに閉じる必要があります。
割り当ての数は、リソースの種類に対して一貫している必要があります (つまり、同じリソースの種類を作成する別のプロセスでは、同じ数と割り当ての種類を生成する必要があります)。さらに、これらのリソースの名前変更は許可されません。

D3DDDI_RESOURCEFLAGS2構造体で指定されたビットフィールドフラグは、D3DDDIARG_CREATERESOURCE2の Flags メンバーで渡されます。

メモリソースは、フラグを指定せずに作成できます。このようなリソースに関連付けられているサーフェスはロックされている可能性があり、ビットブロック転送 (bitblt) 操作でソースまたは宛先にすることができます。ただし、このようなサーフェスは他の用途には使用できません。

メモプレーンサーフェスは、テクスチャまたはプライマリビットフィールドフラグがないため、テクスチャまたはスタンドアロンレンダーターゲットと区別されます。たとえば、 プライマリ ビットフィールドフラグが存在すると、スタンドアロンのレンダーターゲットが示され、このフラグが存在しない場合は、バックバッファーであるレンダーターゲットが示されます。

メモランタイムに対する変更によって既存のドライバーが中断されないようにするには、ドライバーの動作に影響を与える CreateResource2 関数の呼び出しで、D3DDDIARG_CREATERESOURCE2構造体の次の予約メンバーを使用しないようにする必要があります。

Flags メンバーの未定義のビットは予約されています。
[フラグ] でプライマリビットフィールドフラグが設定されていない場合は、RefreshRate メンバーと Output メンバーが予約されます。
RenderTarget、DecodeRenderTarget、または VideoProcessRenderTarget ビットフィールドフラグが Flags で設定されていない場合は、MultisampleType メンバーと MultisampleQuality メンバーが予約されます。
VertexBuffer ビットフィールドフラグが Flags で設定されていない場合、Fvf メンバーは予約されています。
Texture、CubeMap、Volume のビットフィールドフラグが Flags で設定されていない場合、MipLevels メンバーは予約されています。

リソースの作成と破棄の詳細については、「リソースの作成と破棄の処理」を参照してください。

システムメモリリソースの場合、ディスプレイミニポートドライバーは、システムメモリがグラフィックス処理装置 (GPU) による直接アクセス用に適切に配置されている場合に、システムメモリの周囲に割り当てをラップすることを選択できます。ディスプレイミニポートドライバーは、DxgkDdiCreateAllocation 関数を使用して割り当てを作成するときに、DXGK_ALLOCATIONINFO構造体の Flags メンバーに ExistingSysMem フラグを設定することで、システムメモリの周囲に割り当てをラップします。ディスプレイミニポートドライバーがシステムメモリの周囲に割り当てをラップできない場合、またはラップに失敗した場合でも、ドライバーはリソースの作成に成功し、CPU を使用してリソースにアクセスする必要があります。

ランタイムが頂点バッファーまたはインデックスバッファーの作成を要求し、メモリ不足以外の理由でユーザーモードディスプレイドライバーがバッファーを作成できない場合 (ハードウェアサポートの不足など)、ドライバーは D3DERR_NOTAVAILABLEで失敗する必要があります。

要件

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