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 |