D3DDDICB_RECLAIMALLOCATIONS Struktur (d3dumddi.h)

Beschreibt Videospeicherressourcen, die zurückgefordert werden sollen und der zuvor für die Wiederverwendung angebotene Anzeigetreiber für den Benutzermodus. 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;

Angehörige

[in] pResources

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

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

Hinweis Wenn Ressourcen mit dem D3D10_DDI_BIND_PRESENT in pCreateResource->BindFlagsfestgelegten Flagwert erstellt wurden, darf der Treiber nicht das pResources-Element Member verwenden, um von Ressourcenhandles zurückzugeben. Stattdessen muss der Treiber die Ressourcen mithilfe von Zuordnungshandles zurückfordern, die durch HandleList-angegeben werden.

 

[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-Element NULL-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 an derselben Indexposition in den Arrays, auf die durch pResources oder HandleList verwiesen wird.

Das DirectX-Grafik-Kernelsubsystem legt jeden booleschen Wert auf TRUE fest, wenn die entsprechende Ressource verworfen wurde, oder wenn dies nicht der Fall ist, um FALSE zu.

Der Wert 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 das Festlegen pDiscarded- auf NULL- die Leistung verbessern.

[in] NumAllocations

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

CreateResource(D3D11)-

D3D10DDIARG_CREATERESOURCE

pfnReclaimAllocationsCb