Direct3DCreate9 函式 (d3d9.h)

建立 IDirect3D9 物件，並將介面傳回給它。

語法

IDirect3D9 * Direct3DCreate9(
  UINT SDKVersion
);

SDKVersion

類型： UINT

此參數的值應該D3D_SDK_VERSION。請參閱＜備註＞。

類型： IDirect3D9*

如果成功，此函式會傳回 IDirect3D9 介面的指標;否則會傳回 NULL 指標。

Direct3D 對像是圖形化應用程式需要建立的第一個 Direct3D COM 物件，以及應用程式需要釋放的最後一個物件。列舉和擷取裝置功能的函式可透過 Direct3D 物件存取。這可讓應用程式在不建立裝置的情況下選取裝置。

建立 IDirect3D9 物件，如下所示：


LPDIRECT3D9 g_pD3D = NULL;
    
if( NULL == (g_pD3D = Direct3DCreate9(D3D_SDK_VERSION)))
    return E_FAIL;

IDirect3D9 介面支援使用中顯示適配卡的列舉，並允許建立 IDirect3DDevice9 物件。如果用戶藉由將裝置新增至桌面或熱停駐膝上型電腦) ，動態新增適配卡 (，這些裝置將不會包含在列舉中。建立新的 IDirect3D9 介面將會公開新的裝置。

D3D_SDK_VERSION會傳遞至此函式，以確保編譯應用程式的頭檔符合計算機上安裝的運行時間 DLL 版本。只有在標頭變更 (或其他程式碼變更時，D3D_SDK_VERSION才會在運行時間中變更，) 需要重建應用程式。如果此函式失敗，表示頭檔版本與運行時間 DLL 版本不符。

如需範例，請參閱建立裝置 (Direct3D 9) 。