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

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

DxgkDdiCreateAllocation 関数は、システムまたはビデオメモリの割り当てを作成します。

構文

DXGKDDI_CREATEALLOCATION DxgkddiCreateallocation;

NTSTATUS DxgkddiCreateallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_CREATEALLOCATION pCreateAllocation
)
{...}

パラメーター

[in] hAdapter

ディスプレイアダプターに関連付けられているコンテキストブロックへのハンドル。ディスプレイミニポートドライバーは、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターの Microsoft DirectX グラフィックスカーネルサブシステムにこのハンドルを以前に提供しました。

[in/out] pCreateAllocation

割り当てを作成するための情報を含む DXGKARG_CREATEALLOCATION 構造体へのポインター。

戻り値

DxgkDdiCreateAllocation は、次のいずれかの値を返します。

リターンコード	説明
STATUS_SUCCESS	DxgkDdiCreateAllocation によって割り当てが正常に作成されました。
STATUS_INVALID_PARAMETER	DxgkDdiCreateAllocation に渡されたパラメーターには、完了できなかったエラーが含まれていました。
STATUS_NO_MEMORY	DxgkDdiCreateAllocation で、完了するために必要なメモリを割り当てませんでした。
STATUS_GRAPHICS_DRIVER_MISMATCH	ディスプレイミニポートドライバーは、 DxgkDdiCreateAllocation への呼び出しを開始したユーザーモードのディスプレイドライバーと互換性がありません。

注釈

ユーザーモードディスプレイドライバーが pfnAllocateCb 関数を呼び出した後、DirectX グラフィックスカーネルサブシステムは、ディスプレイミニポートドライバーの DxgkDdiCreateAllocation 関数を呼び出して割り当てを作成します。ディスプレイミニポートドライバーは、ユーザーモードディスプレイドライバーから渡されるプライベートデータ (各割り当てのDXGK_ALLOCATIONINFO構造体の pPrivateDriverData メンバー内) を解釈する必要があり、ビデオメモリマネージャーを介して各割り当てを作成するために必要なパラメーターの一覧を決定する必要があります。ディスプレイミニポートドライバーがビデオメモリマネージャーにこれらのパラメーターを提供する方法の詳細については、「割り当てを作成するときにセグメントを指定する」を参照してください。

ディスプレイミニポートドライバーは、割り当てハンドルを返す必要があります。これは通常、割り当てに関する情報を含むプライベートドライバーデータ構造へのポインターです。ディスプレイミニポートドライバーは、割り当てハンドルのプライベートデータを取得するために DxgkCbGetHandleData 関数をいつでも呼び出すことができます。したがって、ディスプレイミニポートドライバーは、プライベート割り当てハンドルテーブルを維持するために必要ありません。実際、高速ユーザースイッチ、ホットプラグなど、ディスプレイモードスイッチのシナリオでは、プライベートハンドルテーブルが古くなったり DirectX グラフィックスカーネルサブシステムと同期しなくなる可能性があるため、強く推奨します。

ユーザーモードディスプレイドライバーは、リソースまたはデバイスに割り当てを割り当てます。割り当てがリソースに属しているかどうかを判断するために、ディスプレイミニポートドライバーは、リソース ビットフィールドフラグが DxgkDdiCreateAllocation の pCreateAllocation パラメーターが指すDXGKARG_CREATEALLOCATION構造体の Flags メンバーに設定されているかどうかをチェックできます。割り当てがリソースに属している場合、ディスプレイミニポートドライバーはリソースハンドルを返すことができます (ただし、必須ではありません)。これは通常、リソースを記述するプライベートドライバーデータ構造へのポインターです。 DirectX グラフィックスカーネルサブシステムが DxgkDdiCreateAllocation を呼び出して既存のリソースの追加の割り当てを作成した場合、DXGKARG_CREATEALLOCATION の hResource メンバーには、そのリソースの以前の DxgkDdiCreateAllocation 呼び出しによって返されたハンドルが含まれます。必要に応じて、ディスプレイミニポートドライバーは 、DxgkDdiCreateAllocation の呼び出し中にリソースハンドルを変更できます。

ユーザーモードディスプレイドライバーがコマンドバッファーにリソースハンドルを配置する場合、ディスプレイミニポートドライバーは DxgkCbGetHandleData を呼び出すことによってプライベートデータを取得できます。ディスプレイミニポートドライバーは、 DxgkCbEnumHandleChildren 関数を呼び出すことによって、リソースのすべての子割り当てを列挙することもできます。

Windows 7 以降では、ディスプレイミニポートドライバーが DXgkDdiCreateAllocation 関数の呼び出しを処理して GDI ハードウェアアクセラレーションの割り当てを作成する場合、ドライバーは割り当てのサイズ (CPU 表示割り当てのピッチ値を含む) を設定する必要があります。pCreateAllocation-pAllocationInfo-Size>。>

DxgkDdiCreateAllocation 呼び出しで作成されたリソースは、デバイスではなくアダプターに属しています。ディスプレイミニポートドライバーは、プライベート割り当ておよびリソースデータ構造内の任意の場所でデバイスデータを参照しないでください。サーフェス共有のため、ユーザーモードディスプレイドライバーによってリソースが作成されたデバイスが破棄された後、リソースが使用されている可能性があります。

DxgkDdiCreateAllocation をページング可能にする必要があります。

履歴バッファーの割り当て

Windows 8.1以降、DxgkDdiCreateAllocation が呼び出されると、ディスプレイミニポートドライバーはDXGK_ALLOCATIONINFOFLAGSを設定できます。ユーザー モードドライバーが履歴バッファーの作成と破棄を管理できることを示す HistoryBuffer メンバー。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL