DXGKDDI_CREATEDEVICE コールバック関数 (d3dkmddi.h)
DXGKDDI_CREATEDEVICE 関数は、ディスプレイ ミニポート ドライバーのデバイス固有の関数の呼び出しで後で使用されるグラフィックス コンテキスト デバイスを作成します。
構文
DXGKDDI_CREATEDEVICE DxgkddiCreatedevice;
NTSTATUS DxgkddiCreatedevice(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_CREATEDEVICE pCreateDevice
)
{...}
パラメーター
hAdapter
[in]ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgiDdiAddDevice 関数の出力パラメーター ミニポートDeviceContext で Dxgkrnl を するために、このハンドルを提供しました。
pCreateDevice
[入力/出力]グラフィックス コンテキスト デバイスを記述する DXGKARG_CREATEDEVICE 構造体へのポインター。
戻り値
DXGKDDI_CREATEDEVICE は、次のいずれかの値を返します。
| リターン コード | 形容 |
|---|---|
| STATUS_SUCCESS | DXGKDDI_CREATEDEVICE グラフィックス コンテキスト デバイスが正常に作成されました。 |
| STATUS_NO_MEMORY | DXGKDDI_CREATEDEVICE 完了するために必要なメモリを割り当てませんでした。 |
備考
Dxgkrnl ディスプレイ ミニポート ドライバーの DXGKDDI_CREATEDEVICE 関数を呼び出して、グラフィックス サブシステムがディスプレイ ミニポート ドライバーの呼び出しで渡すグラフィックス コンテキスト デバイスを作成します。 ドライバーは、デバイスを使用してレンダリング状態のコレクションを保持します。 グラフィックス サブシステムは、特定のグラフィックス処理装置 (GPU) アダプター上の同じプロセスで複数のデバイスを作成できます。
手記
同時に存在できるデバイスの数は、使用可能なシステム メモリによってのみ制限されます。 つまり、ドライバーにハードコーディングされた最大デバイス制限を設定することはできません。
一般に、デバイスは互いに独立しています。つまり、あるデバイスで作成されたリソースは、別のデバイスで作成されたリソースによって参照またはアクセスすることはできません。 ただし、クロスプロセス リソースは、この規則の例外です。
DXGKDDI_CREATEDEVICE ページング可能にする必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |