struttura DXGKARGCB_MAPFRAMEBUFFERPOINTER (d3dkmddi.h)

  • Articolo

La struttura DXGKARGCB_MAPFRAMEBUFFERPOINTER contiene argomenti utilizzati dalla funzione di callback DXGKCB_MAPFRAMEBUFFERPOINTER per eseguire il mapping di un puntatore al buffer dei frame.

Sintassi

typedef struct _DXGKARGCB_MAPFRAMEBUFFERPOINTER {
  [in]     UINT   PhysicalAdapterIndex;
  [in]     SIZE_T Size;
  [in/out] SIZE_T Offset;
  [out]    PVOID  pBaseAddress;
} DXGKARGCB_MAPFRAMEBUFFERPOINTER;

Members

[in] PhysicalAdapterIndex

Indice dell'adattatore fisico.

[in] Size

Dimensione, in byte, dell'area secondaria mappata dell'oggetto sezione. Le dimensioni devono essere un multiplo di PAGE_SIZE.

[in/out] Offset

In base all'input, si tratta dell'offset, espresso in byte, alla sottoregione mappata dell'oggetto sezione. L'offset deve essere un multiplo di PAGE_SIZE. Nell'output si tratta dell'offset dall'indirizzo di base di output in cui il driver deve copiare i dati.

[out] pBaseAddress

Puntatore all'indirizzo di base accessibile dalla CPU alla sottoarea mappata dell'oggetto sezione. Il driver deve aggiungere il valore offset di output all'indirizzo di base per ottenere l'indirizzo di destinazione di qualsiasi operazione di copia (pDestinationAddress = pBaseAddress + Offset).

Commenti

Se l'aggiunta dell'intero oggetto sezione del buffer dei fotogrammi ha esito negativo, il driver deve provare a garantire lo stato di avanzamento eseguendo il trasferimento in parti più piccole. Questa operazione viene eseguita allocando un piccolo MDL o un blocco di memoria durante l'inizializzazione, che può essere usato per trasferire il contenuto dall'hardware e quindi chiamando DXGKCB_MAPFRAMEBUFFERPOINTER per ottenere un puntatore a un'area secondaria dell'oggetto sezione.

Il driver è responsabile della copia dei dati dal buffer preallocato all'area secondaria mappata. Il contrario è true anche quando si ripristina il contenuto del buffer dei frame.

Per altre informazioni, vedere Isolamento GPU basato su IOMMU .

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1803 (WDDM 2.4)
Intestazione d3dkmddi.h

Vedi anche

DXGKCB_MAPFRAMEBUFFERPOINTER