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

DxgkDdiCreateContext 関数は、グラフィックス処理装置 (GPU) コンテキストを作成します。

構文

DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;

NTSTATUS DxgkddiCreatecontext(
  [in]     IN_CONST_HANDLE hDevice,
  [in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}

パラメーター

[in] hDevice

新しいコンテキストが作成されるグラフィックス コンテキスト デバイスへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiCreateDevice 関数は、DXGKARG_CREATEDEVICE 構造体の hDevice メンバー内の Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを以前に提供しました。

[in/out] pCreateContext

コンテキストの作成に関する情報を含む DXGKARG_CREATECONTEXT 構造体へのポインター。

戻り値

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

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

備考

ドライバーは、GPU コンテキストを使用してレンダリング状態のコレクションを保持します。

1 つのプロセスで、特定のデバイスに複数のコンテキストを作成できます。

ドライバーは、任意の数のコンテキストをサポートする必要があります。 ドライバーがコンテキストを作成できなかった唯一の正当な理由は、システム メモリが不足している場合です。

通常、各コンテキストは、そのコンテキストを所有するデバイス用に以前に作成されたすべてのリソースを参照できます。

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h
IRQL	PASSIVE_LEVEL

関連項目

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice の