D3D10CreateDevice1 函式 (d3d10_1.h)

建立代表顯示配接器的 Direct3D 10.1 裝置。

語法

HRESULT D3D10CreateDevice1(
  [in]  IDXGIAdapter         *pAdapter,
  [in]  D3D10_DRIVER_TYPE    DriverType,
  [in]  HMODULE              Software,
  [in]  UINT                 Flags,
  [in]  D3D10_FEATURE_LEVEL1 HardwareLevel,
  [in]  UINT                 SDKVersion,
  [out] ID3D10Device1        **ppDevice
);

參數

[in] pAdapter

類型： IDXGIAdapter*

顯示介面卡的指標 (在建立硬體裝置時，請參閱 IDXGIAdapter) ;否則，請將此參數設定為 Null。 如果在建立硬體裝置時指定 Null ，Direct3D 會使用 EnumAdapters列舉的第一個介面卡。

[in] DriverType

類型： D3D10_DRIVER_TYPE

裝置驅動程式類型 (請參閱 D3D10_DRIVER_TYPE) 。 驅動程式類型會決定您將建立的裝置類型。

[in] Software

類型： HMODULE

除了D3D10_DRIVER_TYPE_SOFTWARE驅動程式類型之外，這會設定為 Null 。

[in] Flags

類型： UINT

選擇性。 裝置建立旗標 (請參閱啟用API 層D3D10_CREATE_DEVICE_FLAG) 。 這些旗標可以一起位 OR。

[in] HardwareLevel

類型： D3D10_FEATURE_LEVEL1

加速可用的硬體版本 (請參閱 D3D10_FEATURE_LEVEL1) 。

[in] SDKVersion

類型： UINT

指出 SDK 版本的位旗標。 應該D3D10_1_SDK_VERSION，定義于 D3D10.h 中。

[out] ppDevice

類型： ID3D10Device1**

(建立之裝置的指標位址，請參閱 ID3D10Device1 介面) 。

傳回值

類型： HRESULT

此方法會傳回下列其中一個 Direct3D 10 傳回碼。

備註

若要同時建立裝置和交換鏈結，請參閱 D3D10CreateDeviceAndSwapChain1。

此方法需要 Windows Vista Service Pack 1、Windows Server 2008 或更新版本的 Windows。

D3D10CreateDevice1 所傳回的物件會實作 IUnknown 介面，並可查詢物件支援的其他介面。 若要擷取 物件的 IDXGIDevice 介面，可以使用下列程式碼。

IDXGIDevice * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
      

規格需求

目標平台	Windows
標頭	d3d10_1.h
程式庫	D3D10_1.lib
Dll	D3D10_1.dll

另請參閱

核心函式