structure DXGKARGCB_MAPFRAMEBUFFERPOINTER (d3dkmddi.h)

La structure DXGKARGCB_MAPFRAMEBUFFERPOINTER contient des arguments utilisés par la fonction de rappel DXGKCB_MAPFRAMEBUFFERPOINTER pour mapper un pointeur de mémoire tampon d’image.

Syntaxe

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

Membres

[in] PhysicalAdapterIndex

Index de l’adaptateur physique.

[in] Size

Taille, en octets, de la sous-région mappée de l’objet section. taille doit être un multiple de PAGE_SIZE.

[in/out] Offset

En entrée, il s’agit du décalage, en octets, de la sous-région mappée de l’objet section. Le décalage doit être un multiple de PAGE_SIZE. En sortie, il s’agit du décalage de l’adresse de base de sortie vers laquelle le pilote doit copier les données.

[out] pBaseAddress

Pointeur d’adresse de base accessible au processeur vers la sous-région mappée de l’objet section. Le pilote doit ajouter la sortie offset valeur à l’adresse de base pour obtenir l’adresse de destination de toutes les opérations de copie (pDestinationAddress = pBaseAddress + Offset).

Remarques

Si l’épinglage de l’objet de section de la mémoire tampon de trame entière échoue, le pilote doit essayer de s’assurer de la progression vers l’avant en effectuant le transfert en petits morceaux. Pour ce faire, allouez un petit MDL ou un segment de mémoire pendant l’initialisation, qui peut être utilisé pour transférer le contenu à partir du matériel, puis en appelant DXGKCB_MAPFRAMEBUFFERPOINTER pour obtenir un pointeur vers un sous-ensemble de l’objet section.

Le pilote est chargé de copier les données à partir de la mémoire tampon pré-allouée vers le sous-réseau mappé. L’inverse est également vrai lors de la restauration du contenu de la mémoire tampon d’images.

Pour plus d’informations, consultez d’isolation GPU basée sur IOMMU.

Exigences

Voir aussi

DXGKCB_MAPFRAMEBUFFERPOINTER