structure D3DKMDT_STAGINGSURFACEDATA (d3dkmdt.h)

Article
05/18/2024

La structure D3DKMDT_STAGINGSURFACEDATA décrit la surface intermédiaire verrouillable dans laquelle les données sont transférées à partir de la mémoire tampon arrière d’une application.

Syntaxe

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

Membres

[in] Width

Largeur de la mémoire tampon intermédiaire, en pixels.

[in] Height

Hauteur de la mémoire tampon intermédiaire, en pixels.

[out] Pitch

Largeur de la mémoire tampon intermédiaire, en octets. Le pilote doit retourner la valeur pitch, car la mémoire tampon intermédiaire est verrouillable.

Remarques

La structure D3DKMDT_STAGINGSURFACEDATA est transmise par le sous-système du noyau graphique Microsoft DirectX dans un appel à la fonction DxgkDdiGetStandardAllocationDriverData du pilote miniport d’affichage pour générer une description d’une surface intermédiaire verrouillable. Le sous-système graphique appelle la fonction DxgkDdiPresent du pilote miniport d’affichage pour émettre des demandes de transfert de bloc de bits (bitblt) pour transférer des données de la mémoire tampon arrière d’une application vers la surface de préproduction. La surface de préproduction est ensuite verrouillée et lue par le processeur.

Une surface intermédiaire est potentiellement créée pour l’opération actuelle lorsqu’un transfert direct de bloc de bits vers la surface primaire n’est pas possible (par exemple, dans les cas de plusieurs moniteurs ou de sprites).

Cette surface intermédiaire est toujours créée sous la forme d’un format de pixel RVB de 8 bits par couleur (qui est spécifié par la valeur D3DDDIFMT_X8R8G8B8 de l’énumération D3DDDIFORMAT ). Étant donné que les dimensions de la surface de préproduction correspondent toujours aux dimensions de la mémoire tampon arrière, aucune opération d’étirement ou de réduction n’est requise pour l’opération actuelle sur la surface intermédiaire.