Funzione D3D12EnableExperimentalFeatures (d3d12.h)

Abilita un elenco di funzionalità sperimentali.

Sintassi

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

Parametri

NumFeatures

Tipo: UINT

Numero di funzionalità sperimentali da abilitare.

[in] pIIDs

Tipo: const IID*

SAL: __in_ecount(NumFeatures)

Puntatore a una matrice di ID che specificano quale delle funzionalità sperimentali disponibili per abilitare.

[in] pConfigurationStructs

Tipo: void*

SAL: __in_ecount(NumFeatures)

Strutture che contengono dettagli di configurazione aggiuntivi che alcune funzionalità sperimentali potrebbero essere abilitate.

[in] pConfigurationStructSizes

Tipo: UINT*

SAL: __in_ecount(NumFeatures)

Dimensioni di tutti gli struct di configurazione passati nel parametro pConfigurationStructs.

Valore restituito

Tipo: HRESULT

Questo metodo restituisce un codice di esito positivo o di errore HRESULT che può includere E_NOINTERFACE se viene specificata una funzionalità non riconosciuta o la modalità sviluppatore non è abilitata o E_INVALIDARG se la configurazione di una funzionalità è corretta, le funzionalità sperimentali specificate non sono compatibili o altri errori.

Commenti

Chiamare questa funzione prima della creazione del dispositivo.

Poiché il set di funzionalità sperimentali cambierà nel tempo e poiché queste funzionalità potrebbero non essere stabili, sono destinate solo allo sviluppo e alla sperimentazione. Questa operazione viene applicata richiedendo che la modalità sviluppatore sia attiva prima che tutte le funzionalità sperimentali possano essere abilitate.

Il set di funzionalità sperimentali attualmente supportate è disponibile nell'intestazione D3D12.h, vicino alla definizione della funzione D3D12EnableExperimentalFeatures; poiché le funzionalità sperimentali sono rese disponibili raramente, il suo tipico per trovare che non sono attualmente supportate funzionalità sperimentali.

Alcune funzionalità sperimentali possono essere identificate usando un IID come GUID. Per queste funzionalità, è possibile usare D3D12GetDebugInterface, passando un IID come parametro, per recuperare l'interfaccia per la modifica di tale funzionalità.

Se questa funzione viene chiamata di nuovo con un elenco diverso di funzionalità da abilitare, tutti i dispositivi D3D12 correnti vengono impostati sullo stato DEVICE_REMOVED.

Esempio

In questo esempio viene illustrato l'aspetto di una definizione di funzionalità sperimentale.

// --------------------------------------------------------------------------------------------------------------------------------
// 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 }
};
	

Requisiti

Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	D3D12.lib
DLL	D3D12.dll

Vedi anche

Funzioni di sistema