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 2012 および Windows Server 2008 R2 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
ターゲット プラットフォーム の | ウィンドウズ |
ヘッダー | d2d1_1.h |
DLL | D2d1.dll |
関連項目
D2D1CreateDevice の