Metodo ID3D12Device4::CreateCommittedResource1 (d3d12.h)

Articolo
08/23/2023

Crea sia una risorsa che un heap implicito (facoltativamente per una sessione protetta), in modo che l'heap sia sufficientemente grande da contenere l'intera risorsa e che la risorsa sia mappata all'heap. Vedere anche ID3D12Device::CreateCommittedResource per un esempio di codice.

Sintassi

HRESULT CreateCommittedResource1(
  [in]            const D3D12_HEAP_PROPERTIES    *pHeapProperties,
  [in]            D3D12_HEAP_FLAGS               HeapFlags,
  [in]            const D3D12_RESOURCE_DESC      *pDesc,
  [in]            D3D12_RESOURCE_STATES          InitialResourceState,
  [in, optional]  const D3D12_CLEAR_VALUE        *pOptimizedClearValue,
  [in, optional]  ID3D12ProtectedResourceSession *pProtectedSession,
  [in]            REFIID                         riidResource,
  [out, optional] void                           **ppvResource
);

Parametri

[in] pHeapProperties

Tipo: const D3D12_HEAP_PROPERTIES*

Puntatore a una struttura D3D12_HEAP_PROPERTIES che fornisce proprietà per l'heap della risorsa.

[in] HeapFlags

Tipo: D3D12_HEAP_FLAGS

Opzioni dell'heap, come combinazione or bit per bit di costanti di enumerazione D3D12_HEAP_FLAGS .

[in] pDesc

Tipo: const D3D12_RESOURCE_DESC*

Puntatore a una struttura D3D12_RESOURCE_DESC che descrive la risorsa.

[in] InitialResourceState

Tipo: D3D12_RESOURCE_STATES

Lo stato iniziale della risorsa, come combinazione or bit per bit di D3D12_RESOURCE_STATES costanti di enumerazione.

Quando si crea una risorsa insieme a un heap D3D12_HEAP_TYPE_UPLOAD , è necessario impostare InitialResourceState su D3D12_RESOURCE_STATE_GENERIC_READ.

Quando si crea una risorsa con un heap D3D12_HEAP_TYPE_READBACK , è necessario impostare InitialResourceState su D3D12_RESOURCE_STATE_COPY_DEST.

[in, optional] pOptimizedClearValue

Tipo: const D3D12_CLEAR_VALUE*

Specifica una struttura D3D12_CLEAR_VALUE che descrive il valore predefinito per un colore chiaro.

pOptimizedClearValue specifica un valore per il quale le operazioni cancellate sono ottimali. Quando la risorsa creata è una trama con i flag D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET o D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL , è necessario scegliere il valore con cui verrà chiamata l'operazione cancellata. È possibile chiamare l'operazione di cancellazione con altri valori, ma queste operazioni non saranno altrettanto efficienti come quando il valore corrisponde a quello passato alla creazione di risorse.

Quando si usa D3D12_RESOURCE_DIMENSION_BUFFER, è necessario impostare pOptimizedClearValue su nullptr.

[in, optional] pProtectedSession

Tipo: ID3D12ProtectedResourceSession*

Puntatore facoltativo a un oggetto che rappresenta una sessione per la protezione del contenuto. Se specificato, questa sessione indica che la risorsa deve essere protetta. Puoi ottenere un ID3D12ProtectedResourceSession chiamando ID3D12Device4::CreateProtectedResourceSession.

[in] riidResource

Tipo: REFIID

Riferimento all'identificatore univoco globale (GUID) dell'interfaccia della risorsa da restituire in ppvResource.

Anche se riidResource è in genere il GUID di ID3D12Resource, può essere il GUID di qualsiasi interfaccia. Se l'oggetto risorsa non supporta l'interfaccia per questo GUID, la creazione ha esito negativo con E_NOINTERFACE.

[out, optional] ppvResource

Tipo: void**

Puntatore facoltativo a un blocco di memoria che riceve il puntatore di interfaccia richiesto all'oggetto risorsa creato.

ppvResource può essere nullptr, per abilitare il test delle funzionalità. Quando ppvResource è nullptr, non viene creato alcun oggetto e S_FALSE viene restituito quando pDesc è valido.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Valore restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente per creare la risorsa.

Per altri possibili valori restituiti, vedere Codici restituiti Direct3D 12 .

Commenti

Questo metodo crea sia una risorsa che un heap, in modo che l'heap sia sufficientemente grande da contenere l'intera risorsa e che la risorsa sia mappata all'heap. L'heap creato è noto come heap implicito, perché l'oggetto heap non può essere ottenuto dall'applicazione. Prima di rilasciare il riferimento finale nella risorsa, l'applicazione deve assicurarsi che la GPU non leggerà né scriverà in questa risorsa.

L'heap implicito viene reso residente per l'accesso alla GPU prima che il metodo restituisca il controllo all'applicazione. Vedi anche Residenza.

Non è possibile modificare il mapping della risorsa GPU VA. Vedere ID3D12CommandQueue::UpdateTileMappings e Risorse affiancate del volume.

Questo metodo può essere chiamato contemporaneamente da più thread.

Requisiti


Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	d3d12.lib
DLL	d3d12.dll

Condividi tramite