ID3D12Device3::EnqueueMakeResident-Methode (d3d12.h)

Macht Objekte asynchron für das Gerät resident.

Syntax

HRESULT EnqueueMakeResident(
       D3D12_RESIDENCY_FLAGS Flags,
       UINT                  NumObjects,
  [in] ID3D12Pageable        * const *ppObjects,
  [in] ID3D12Fence           *pFenceToSignal,
       UINT64                FenceValueToSignal
);

Parameter

Flags

Typ: D3D12_RESIDENCY_FLAGS

Steuert, ob die Objekte als resident festgelegt werden sollen, wenn die Anwendung ihr Arbeitsspeicherbudget überschreitet.

NumObjects

Typ: UINT

Die Anzahl der Objekte im ppObjects-Array , die als Resident für das Gerät verwendet werden sollen.

[in] ppObjects

Typ: ID3D12Pageable*

Ein Zeiger auf einen Speicherblock; enthält ein Array von ID3D12Pageable-Schnittstellenzeigern für die Objekte.

Obwohl die meisten D3D12-Objekte von ID3D12Pageable erben, werden Residenzänderungen nur für Folgendes unterstützt:

• Deskriptorheaps
• Heaps
• Commit für Ressourcen
• Abfrageheaps

[in] pFenceToSignal

Typ: ID3D12Fence*

Ein Zeiger auf den Zaun, mit dem signalisiert wird, wenn die Arbeit abgeschlossen ist.

FenceValueToSignal

Typ: UINT64

Ein nicht signierter 64-Bit-Wert, der dem Zaun signalisiert wird, wenn die Arbeit abgeschlossen ist.

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen der Direct3D 12-Rückgabecodes zurück.

Hinweise

EnqueueMakeResident führt die gleichen Aktionen wie MakeResident aus, wartet jedoch nicht, bis die Ressourcen als resident festgelegt werden. Stattdessen signalisiert EnqueueMakeResident einen Zaun, wenn die Arbeit abgeschlossen ist.

Das System lässt keine Arbeit zu, die auf die Ressourcen verweist, die mithilfe von EnqueueMakeResident vor dem Signal des Zauns als Resident festgelegt werden. Stattdessen wird bei Aufrufen dieser API garantiert der entsprechende Zaun in der richtigen Reihenfolge signalisiert, sodass derselbe Zaun vom Aufruf bis zum Aufruf verwendet werden kann.

Anforderungen

Weitere Informationen

ID3D12Device

ID3D12Device3