D2D1CreateDeviceContext 関数 (d2d1_1.h)

[アーティクル]
03/05/2024

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