D2D1CreateDeviceContext 関数 (d2d1_1.h)
DXGI サーフェスに関連付けられた新しい Direct2D デバイス コンテキストを作成します。
構文
HRESULT D2D1CreateDeviceContext(
[in] IDXGISurface *dxgiSurface,
[in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
[out] ID2D1DeviceContext **d2dDeviceContext
);
パラメーター
[in] dxgiSurface
Direct2D デバイス コンテキストが関連付けられている DXGI サーフェス。
[in, optional] creationProperties
Direct2D デバイス コンテキストに適用するプロパティ。
[out] d2dDeviceContext
この関数から制御が戻るときに、Direct2D デバイス コンテキストへのポインターのアドレスが格納されます。
戻り値
関数は HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| HRESULT | 説明 |
|---|---|
| S_OK | エラーは発生していません。 |
| E_OUTOFMEMORY | Direct2D は、呼び出しを完了するのに十分なメモリを割り当てませんでした。 |
| E_INVALIDARG | 無効な値が メソッドに渡されました。 |
注釈
この関数では、 ID2D1Resource::GetFactory を使用して取得できる新しい ID2D1Factory1 も作成されます。
この関数では、 ID2D1DeviceContext::GetDevice を使用して取得できる新しい ID2D1Device も作成されます。
DXGI デバイスは、 dxgiSurface を介して暗黙的に指定されます。
creationProperties が指定されていない場合、Direct2D デバイスは dxgiSurface によって暗黙的に指定された DXGI デバイスからスレッド モードを継承し、デバッグ トレースは有効になりません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1_1.h |
| [DLL] | D2d1.dll |