Skip to main content
実験的機能のリストを有効にします。

構文

パラメーター

NumFeatures
型: UINT
有効にする実験的機能の数。 pIIDs [in]
型: const IID *
SAL: __in_ecount(NumFeatures) 利用可能な実験的機能のうち、どれを有効にするかを指定する ID の配列へのポインター。 pConfigurationStructs [in]
型: void *
SAL: __in_ecount(NumFeatures) 一部の実験的機能を有効にするために必要となる追加の構成の詳細を含む構造体。 pConfigurationStructSizes [in]
型: UINT *
SAL: __in_ecount(NumFeatures) pConfigurationStructs パラメーターで渡される構成構造体のサイズ。

戻り値

型: HRESULT このメソッドは HRESULT の成功またはエラー コードを返します。認識されない機能が指定されているか、開発者モードが有効になっていない場合は E_NOINTERFACE、機能の構成が正しくないか、指定された実験的機能が互換性がないなどのエラーの場合は E_INVALIDARG が含まれる場合があります。

解説

デバイス作成前にこの関数を呼び出します。 実験的機能のセットは時間とともに変化し、これらの機能は安定していない可能性があるため、開発および実験目的でのみ使用することを目的としています。これは、実験的機能を有効にする前に開発者モードが有効である必要があるという要件によって強制されます。 現在サポートされている実験的機能のセットは、D3D12EnableExperimentalFeatures 関数の定義付近の D3D12.h ヘッダーで確認できます。実験的機能は頻繁には提供されないため、通常は現在サポートされている実験的機能がないことが一般的です。 一部の実験的機能は、GUID として IID を使用して識別される場合があります。これらの機能では、D3D12GetDebugInterface にパラメーターとして IID を渡すことで、その機能を操作するためのインターフェイスを取得できます。 この関数が異なる機能のリストで再度呼び出されると、現在のすべての D3D12 デバイスは DEVICE_REMOVED 状態に設定されます。

この例では、実験的機能の定義がどのように見えるかを示します。

要件

ヘッダー: d3d12_xs.h または d3d12_x.h
ライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされるプラットフォーム: XBOX Series 本体および XBOX One ファミリ

関連項目

コア関数
最終更新日 2026年8月24日