D3D12EnableExperimentalFeatures 函式 (d3d12.h)

  • 發行項

啟用實驗性功能的清單。

語法

HRESULT D3D12EnableExperimentalFeatures(
       UINT      NumFeatures,
  [in] const IID *pIIDs,
  [in] void      *pConfigurationStructs,
  [in] UINT      *pConfigurationStructSizes
);

參數

NumFeatures

類型： UINT

要啟用的實驗性功能數目。

[in] pIIDs

類型： const IID*

SAL： __in_ecount(NumFeatures)

識別碼陣列的指標，指定要啟用的可用實驗性功能。

[in] pConfigurationStructs

類型： void*

SAL： __in_ecount(NumFeatures)

包含某些實驗性功能可能需要啟用之其他設定詳細資料的結構。

[in] pConfigurationStructSizes

類型： UINT*

SAL： __in_ecount(NumFeatures)

在 pConfigurationStructs 參數中傳遞的任何組態結構大小。

傳回值

類型： HRESULT

這個方法會傳回 HRESULT 成功或錯誤碼，如果指定了無法辨識的功能或未啟用開發人員模式，或如果功能設定正確、指定的實驗性功能不相容或其他錯誤，則E_INVALIDARG包含E_NOINTERFACE。

備註

在裝置建立之前呼叫此函式。

由於一組實驗性功能會隨著時間而變更，而且這些功能可能不穩定，因此僅供開發和實驗之用。 在啟用任何實驗性功能之前，必須先啟用開發人員模式，才能強制執行此動作。

目前支援的一組實驗性功能可以在 D3D12.h 標頭中找到，接近 D3D12EnableExperimentalFeatures 函式的定義;因為實驗性功能只會不常提供，所以通常找不到目前不支援任何實驗性功能。

某些實驗性功能可能會使用 IID 作為 GUID 來識別。 針對這些功能，您可以使用 D3D12GetDebugInterface 傳遞 IID 作為參數，以擷取操作該功能的介面。

如果再次呼叫此函式並顯示要啟用的不同功能清單，則所有目前的 D3D12 裝置都會設定為DEVICE_REMOVED狀態。

範例

此範例顯示實驗性功能定義的外觀。

// --------------------------------------------------------------------------------------------------------------------------------
// Experimental Feature: D3D12ExperimentalShaderModels
//
// Use with D3D12EnableExperimentalFeatures to enable experimental shader model support,
// meaning shader models that haven't been finalized for use in retail.
//
// Enabling D3D12ExperimentalShaderModels needs no configuration struct, pass NULL in the pConfigurationStructs array.
//
// --------------------------------------------------------------------------------------------------------------------------------
static const UUID D3D12ExperimentalShaderModels = { /* 76f5573e-f13a-40f5-b297-81ce9e18933f */
    0x76f5573e,
    0xf13a,
    0x40f5,
    { 0xb2, 0x97, 0x81, 0xce, 0x9e, 0x18, 0x93, 0x3f }
};

需求

   
目標平台 Windows
標頭 d3d12.h
程式庫 D3D12.lib
Dll D3D12.dll

另請參閱

核心函式