struttura D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Articolo
05/18/2024

La struttura D3DKMDT_SHADOWSURFACEDATA descrive una superficie ombreggiatura bloccabile, che corrisponde alla superficie primaria in formato e risoluzione per una determinata modalità di visualizzazione.

Sintassi

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

Members

[in] Width

Larghezza della superficie, in pixel. Il driver restituisce il valore di larghezza.

[in] Height

Altezza della superficie, in pixel. Il driver restituisce il valore di altezza.

[in] Format

Valore tipizzato D3DDDIFORMAT che indica il formato pixel della superficie. Il driver restituisce il valore di formato.

[out] Pitch

Larghezza della superficie, in byte. Il driver deve restituire il valore di inclinazione perché la superficie ombreggiatura è bloccabile.

Commenti

La struttura D3DKMDT_SHADOWSURFACEDATA viene passata dal sottosistema kernel grafico Microsoft DirectX in una chiamata alla funzione DxgkDdiGetStandardAllocationDriverData del driver miniport di visualizzazione per generare una descrizione di una superficie ombreggiatura bloccabile. Il sottosistema kernel grafico DirectX usa la descrizione in una chiamata alla funzione DxgkDdiCreateAllocation del driver miniport per visualizzare la superficie ombreggiatura bloccabile.

La CPU si inserisce nella superficie ombreggiata bloccata, sblocca la superficie d'ombra e quindi invia richieste di trasferimento bit-block (bitblt) tramite la funzione DxgkDdiPresent dalla superficie di ombreggiatura alla superficie primaria condivisa corrispondente. Le richieste di trasferimento a blocchi di bit vengono inoltre inviate per trasferire i dati da una superficie primaria condivisa nella superficie shadow.

Non è necessaria un'operazione di conversione, estensione o compattazione dei colori quando si copiano dati da o in una superficie ombreggiatura perché i formati e le dimensioni di origine e destinazione delle superfici primarie condivise corrispondono sempre.