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 を含む)

こちらもご覧ください

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice