PFND3DDDI_CREATEDEVICE コールバック関数 (d3dumddi.h)
CreateDevice 関数は、後続の呼び出しで参照されるグラフィックス コンテキストを作成します。
構文
PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;
HRESULT Pfnd3dddiCreatedevice(
HANDLE hAdapter,
D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}
パラメーター
hAdapter
グラフィックス アダプターを識別するハンドル。
unnamedParam2
pCreateData [in, out]
D3DDDIARG_CREATEDEVICE構造体へのポインター。 入力時に、この構造体にはドライバーが使用できる情報が含まれます。 出力時に、ドライバーは、Microsoft Direct3D ランタイムが使用できる構造体内の情報を指定します。
戻り値
CreateDevice は 、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| S_OK | グラフィックス コンテキストが正常に作成されました。 |
| E_OUTOFMEMORY | CreateDevice は、完了するために必要なメモリを割り当てませんでした。 |
注釈
ディスプレイ デバイスは、レンダリング状態のコレクションを保持するために使用されるグラフィックス コンテキストです。 特定のアダプターで同じプロセスによって複数のデバイスを作成できます。 同時に存在できるディスプレイ・デバイスの数は、使用可能なシステム・メモリーによってのみ制限されることに注意してください。 つまり、ドライバーはデバイスの上限をハードコーディングできません。
一般に、デバイスは互いに独立しているため、あるデバイスで作成されたリソースは、別のデバイスで作成されたリソースによって参照またはアクセスできなくなります。 ただし、クロスプロセス リソースは、このルールの例外です。
Direct3D ランタイムが CreateDevice を 呼び出してデバイスを作成する場合、ランタイムはデバイスの実行の既定のグラフィックス処理装置 (GPU) コンテキスト スレッドを作成しません。 ドライバーは、必要に応じて 1 つ以上のコンテキストを作成するために 、pfnCreateContextCb 関数を明示的に呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |