D3DDDICB_RECLAIMALLOCATIONS-Struktur (d3dumddi.h)

Artikel
02/23/2024

Beschreibt Videospeicherressourcen, die zurückgewonnen werden sollen und die der Benutzermodusanzeigetreiber zuvor zur Wiederverwendung angeboten hat. Wird mit der Funktion pfnReclaimAllocationsCb verwendet.

Syntax

typedef struct _D3DDDICB_RECLAIMALLOCATIONS {
  [in]  const HANDLE        *pResources;
  [in]  const D3DKMT_HANDLE *HandleList;
  [out] BOOL                *pDiscarded;
  [in]  UINT                NumAllocations;
} D3DDDICB_RECLAIMALLOCATIONS;

Member

[in] pResources

Ein Zeiger auf ein Array von Handles auf die Ressourcen, die zurückgewonnen werden sollen.

Wenn pResources nicht NULL ist, muss das HandleList-ElementNULL sein.

Hinweis Wenn Ressourcen mit dem in pCreateResource->BindFlags festgelegten D3D10_DDI_BIND_PRESENT-Flagwert erstellt wurden, darf der Treiber nicht das pResources-Element verwenden, um nach Ressourcenhandles zurückzufordern. Stattdessen muss der Treiber die Ressourcen mithilfe der von HandleList angegebenen Zuordnungshandles zurückfordern.

[in] HandleList

Ein Array von D3DKMT_HANDLE Datentypen, die Kernelmodushandles für die Zuordnungen darstellen, die zurückgefordert werden sollen.

Wenn HandleList nicht NULL ist, muss das pResources-ElementNULL sein.

[out] pDiscarded

Ein Array boolescher Werte, die angeben, ob jede Ressource oder Zuordnung verworfen wurde.

Jeder boolesche Wert in diesem Array entspricht einer Ressource am gleichen Indexspeicherort in den Arrays, auf die von pResources oder HandleList verwiesen wird.

Das DirectX-Grafikkernsubsystem legt jeden booleschen Wert auf TRUE fest, wenn die korrelierende Ressource verworfen wurde, oder auf FALSE , falls nicht.

Der Wert von pDiscarded kann NULL sein. Wenn der Treiber ihn auf NULL festlegt, kann davon ausgegangen werden, dass der Inhalt der Ressource oder Zuordnung verloren geht. Wenn der Treiber den Inhalt der Ressource oder Zuordnung nicht benötigt, kann die Einstellung von pDiscarded auf NULL die Leistung verbessern.

[in] NumAllocations

Die Anzahl der Elemente in den Elementen pResources, HandleList oder pDiscarded , je nachdem, welcher Wert nicht NULL ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

CreateResource(D3D11)

D3D10DDIARG_CREATERESOURCE

pfnReclaimAllocationsCb

Share via