D3DX10CreateDevice 函式

建立代表顯示介面卡的最佳 Direct3D 10 裝置。 如果可以建立 Direct3D 10.1 相容裝置，則可以從傳回的裝置介面指標取得 ID3D10Device1 介面 指標。

語法

HRESULT D3DX10CreateDevice(
  _In_  IDXGIAdapter      *pAdapter,
  _In_  D3D10_DRIVER_TYPE DriverType,
  _In_  HMODULE           Software,
  _In_  UINT              Flags,
  _Out_ ID3D10Device      **ppDevice
);

參數

pAdapter [in]

類型： IDXGIAdapter*

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

DriverType [in]

類型： D3D10_DRIVER_TYPE

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

軟體 [in]

類型： HMODULE

實作軟體驅動程式的載入模組控制碼， (例如D3D10Ref.dll) 。 若要取得控制碼，請呼叫 GetModuleHandle 函 式。

旗標 [in]

類型： UINT

裝置建立旗標 (會看到啟用API 層) D3D10_CREATE_DEVICE_FLAG列舉。 這些旗標可以一起位 OR。

ppDevice [out]

類型： ID3D10Device**

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

傳回值

類型： HRESULT

此函式會傳回下列其中一個 Direct3D 10 傳回碼。

備註

此函式會嘗試為硬體建立最佳裝置。 首先，函式會嘗試建立 10.1 裝置。 如果無法建立 10.1 裝置，函式會嘗試建立 10.0 裝置。 如果兩個裝置都未成功建立，函式會傳回E_FAIL。

如果您的應用程式只需要建立 10.1 裝置或僅限 10.0 裝置，請改用下列功能：

• 使用 D3D10CreateDevice 函式僅建立 Direct3D 10.0 裝置。
• 使用 D3D10CreateDevice1 函式僅建立 Direct3D 10.1 裝置。
• 使用D3DX10GetFeatureLevel1函式，從ID3D10Device 介面指標取得 ID3D10Device1介面指標。

Direct3D 10.1 裝置只能在執行 Windows Vista Service Pack 1 或更新版本的電腦上建立，並安裝 Direct3D 10.1 相容硬體。 不過，在執行已安裝 D3DX10 DLL 的任何 Windows 版本電腦上呼叫此函式是合法的。

規格需求

需求	值
標頭	D3DX10Core.h

另請參閱

常規用途函式