D2D1CreateDeviceContext 函式 (d2d1_1.h)

發行項
03/13/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