struttura D3DDDICB_RECLAIMALLOCATIONS (d3dumddi.h)

Articolo
03/08/2023

Descrive le risorse di memoria video che devono essere recuperate e che il driver di visualizzazione in modalità utente offerto in precedenza per il riutilizzo. Usato con la funzione pfnReclaimAllocationsCb .

Sintassi

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

Members

[in] pResources

Puntatore a una matrice di handle per le risorse da recuperare.

Se pResources non è NULL, il membro HandleList deve essere NULL.

Nota Se le risorse sono state create con il valore del flag D3D10_DDI_BIND_PRESENT impostato in pCreateResource->BindFlags, il driver non deve usare il membro pResources per recuperare da handle di risorse. Al contrario, il driver deve recuperare le risorse usando handle di allocazione specificati da HandleList.

[in] HandleList

Matrice di tipi di dati D3DKMT_HANDLE che rappresentano handle in modalità kernel per le allocazioni da recuperare.

Se HandleList non è NULL, il membro pResources deve essere NULL.

[out] pDiscarded

Matrice di valori booleani che specificano se ogni risorsa o allocazione è stata eliminata.

Ogni valore booleano in questa matrice corrisponde a una risorsa nella stessa posizione di indice nelle matrici a cui punta pResources o HandleList.

Il sottosistema kernel della grafica DirectX imposta ogni valore booleano su TRUE se la risorsa corrispondente è stata eliminata o su FALSE in caso contrario.

Il valore di pDiscarded può essere NULL. Se il driver lo imposta su NULL, si può presumere che il contenuto della risorsa o dell'allocazione vada perso. Se il driver non necessita del contenuto della risorsa o dell'allocazione, l'impostazione di pDiscarded su NULL potrebbe migliorare le prestazioni.

[in] NumAllocations

Numero di elementi nei membri pResources, HandleList o pDiscarded , indipendentemente da NULL.