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 |