struttura D3DKMDT_STAGINGSURFACEDATA (d3dkmdt.h)

Articolo
05/18/2024

La struttura D3DKMDT_STAGINGSURFACEDATA descrive la superficie di gestione temporanea bloccabile in cui i dati vengono trasferiti dal buffer nascosto di un'applicazione.

Sintassi

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

Members

[in] Width

Larghezza del buffer di staging, in pixel.

[in] Height

Altezza del buffer di staging, in pixel.

[out] Pitch

Larghezza del buffer di staging, in byte. Il driver deve restituire il valore di inclinazione perché il buffer di staging è bloccabile.

Commenti

La struttura D3DKMDT_STAGINGSURFACEDATA 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 di staging bloccabile. Il sottosistema grafico chiama la funzione DxgkDdiPresent del driver miniport di visualizzazione per inviare richieste di trasferimento bit-block (bitblt) per trasferire i dati dal buffer nascosto di un'applicazione nella superficie di staging. L'area di gestione temporanea viene quindi bloccata e letta dalla CPU.

Una superficie di gestione temporanea viene potenzialmente creata per l'operazione corrente quando non è possibile trasferire un blocco di bit diretto alla superficie primaria (ad esempio, in casi di più monitor o sprite).

Questa superficie di staging viene sempre creata come formato pixel RGB a 8 bit per colore ,specificato dal valore D3DDDIFMT_X8R8G8B8 dell'enumerazione D3DDDIFORMAT . Poiché le dimensioni della superficie di staging corrispondono sempre alle dimensioni del buffer nascosto, non è necessaria alcuna operazione di estensione o compattazione per l'operazione corrente nella superficie di staging.