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
対象プラットフォーム デスクトップ
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

DXGKARG_CREATECONTEXT

DXGKARG_CREATEDEVICE

DxgkDdiCreateDevice