ID3D12Device8::CreateCommittedResource2-Methode (d3d12.h)
Erstellt sowohl eine Ressource als auch einen impliziten Heap (optional für eine geschützte Sitzung), sodass der Heap groß genug ist, um die gesamte Ressource zu enthalten, und die Ressource wird dem Heap zugeordnet. Siehe auch ID3D12Device::CreateCommittedResource- für ein Codebeispiel.
Syntax
HRESULT CreateCommittedResource2(
const D3D12_HEAP_PROPERTIES *pHeapProperties,
D3D12_HEAP_FLAGS HeapFlags,
const D3D12_RESOURCE_DESC1 *pDesc,
D3D12_RESOURCE_STATES InitialResourceState,
const D3D12_CLEAR_VALUE *pOptimizedClearValue,
ID3D12ProtectedResourceSession *pProtectedSession,
REFIID riidResource,
void **ppvResource
);
Parameter
pHeapProperties
Typ: _In_ const D3D12_HEAP_PROPERTIES*
Ein Zeiger auf eine D3D12_HEAP_PROPERTIES Struktur, die Eigenschaften für den Heap der Ressource bereitstellt.
HeapFlags
Typ: D3D12_HEAP_FLAGS
Heapoptionen als bitweise OR'd-Kombination aus D3D12_HEAP_FLAGS Enumerationskonstanten.
pDesc
Typ: D3D12_RESOURCE_DESC1*
Ein Zeiger auf eine D3D12_RESOURCE_DESC1 Struktur, die die Ressource beschreibt, einschließlich eines Mip-Bereichs.
InitialResourceState
Der Anfangszustand der Ressource als bitweise OR'd-Kombination aus D3D12_RESOURCE_STATES Enumerationskonstanten.
Wenn Sie eine Ressource zusammen mit einem D3D12_HEAP_TYPE_UPLOAD Heap erstellen, müssen Sie InitialResourceState- auf D3D12_RESOURCE_STATE_GENERIC_READfestlegen.
Wenn Sie eine Ressource zusammen mit einem D3D12_HEAP_TYPE_READBACK Heap erstellen, müssen Sie InitialResourceState- auf D3D12_RESOURCE_STATE_COPY_DESTfestlegen.
pOptimizedClearValue
Typ: D3D12_CLEAR_VALUE*
Gibt eine D3D12_CLEAR_VALUE Struktur an, die den Standardwert für eine klare Farbe beschreibt.
pOptimizedClearValue gibt einen Wert an, für den klare Vorgänge am besten geeignet sind. Wenn die erstellte Ressource eine Textur mit dem D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET oder D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL Flags ist, sollten Sie den Wert auswählen, mit dem der clear-Vorgang am häufigsten aufgerufen wird. Sie können den eindeutigen Vorgang mit anderen Werten aufrufen, diese Vorgänge sind jedoch nicht so effizient, wie wenn der Wert dem wert entspricht, der an die Ressourcenerstellung übergeben wird.
Wenn Sie D3D12_RESOURCE_DIMENSION_BUFFERverwenden, müssen Sie pOptimizedClearValue- auf nullptrfestlegen.
pProtectedSession
Typ: ID3D12ProtectedResourceSession*
Ein optionaler Zeiger auf ein Objekt, das eine Sitzung für den Inhaltsschutz darstellt. Wenn angegeben, gibt diese Sitzung an, dass die Ressource geschützt werden soll. Sie können eine ID3D12ProtectedResourceSession- abrufen, indem Sie ID3D12Device4::CreateProtectedResourceSessionaufrufen.
riidResource
Typ: REFIID-
Ein Verweis auf den global eindeutigen Bezeichner (GUID) der Ressourcenschnittstelle, die in ppvResource-zurückgegeben werden soll.
Während riidResource- am häufigsten die GUID-ID3D12Resource-ist, kann es sich um die GUID- jeder Schnittstelle handelt. Wenn das Ressourcenobjekt die Schnittstelle für diese GUID-nicht unterstützt, schlägt die Erstellung mit E_NOINTERFACEfehl.
ppvResource
Typ: void**
Ein optionaler Zeiger auf einen Speicherblock, der den angeforderten Schnittstellenzeiger auf das erstellte Ressourcenobjekt empfängt.
ppvResource- kann nullptrwerden, um Funktionstests zu ermöglichen. Wenn ppvResource-nullptrist, wird kein Objekt erstellt, und S_FALSE wird zurückgegeben, wenn pDesc- gültig ist.
Rückgabewert
Typ: HRESULT-
Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.
| Rückgabewert | Beschreibung |
|---|---|
| E_OUTOFMEMORY | Es ist nicht genügend Arbeitsspeicher vorhanden, um die Ressource zu erstellen. |
Weitere mögliche Rückgabewerte finden Sie unter Direct3D 12-Rückgabecodes.
Bemerkungen
Diese Methode erstellt sowohl eine Ressource als auch einen Heap, sodass der Heap groß genug ist, um die gesamte Ressource zu enthalten, und die Ressource wird dem Heap zugeordnet. Der erstellte Heap wird als impliziter Heap bezeichnet, da das Heap-Objekt nicht von der Anwendung abgerufen werden kann. Bevor Sie den endgültigen Verweis auf die Ressource freigeben, muss Ihre Anwendung sicherstellen, dass die GPU diese Ressource nicht mehr lesen oder schreiben wird.
Der implizite Heap wird für den GPU-Zugriff resident, bevor die Methode die Steuerung an Ihre Anwendung zurückgibt. Siehe auch Residency.
Die GPU-VA-Zuordnung der Ressource kann nicht geändert werden. Siehe ID3D12CommandQueue::UpdateTileMappings und volume tiled resources.
Diese Methode kann von mehreren Threads gleichzeitig aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 Build 20348 |
| mindestens unterstützte Server- | Windows 10 Build 20348 |
| Header- | d3d12.h |
| Library | d3d12.lib |
| DLL- | d3d12.dll |