structure D3DKMDT_STAGINGSURFACEDATA (d3dkmdt.h)

Article
02/06/2025

La structure D3DKMDT_STAGINGSURFACEDATA décrit la surface intermédiaire verrouillée vers laquelle les données sont transférées à partir de la mémoire tampon back 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 de pitch, car la mémoire tampon intermédiaire est verrouillée.

Remarques

La structure D3DKMDT_STAGINGSURFACEDATA est passée par le sous-système du noyau graphique Microsoft DirectX dans un appel au DxgkDdiGetStandardAllocationDriverData du pilote display miniport pour générer une description d’une surface intermédiaire verrouillée. Le sous-système graphique appelle la fonction d' DxgkDdiPresent du pilote miniport d’affichage pour émettre des demandes de transfert de bloc de bits (bitblt) pour transférer des données à partir de la mémoire tampon back d’une application dans la surface intermédiaire. La surface intermédiaire 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 plusieurs cas de moniteur ou de sprites).

Cette surface intermédiaire est toujours créée en tant que 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 intermédiaire correspondent toujours aux dimensions de la mémoire tampon arrière, aucune opération d’étirement ou de réduction n’est nécessaire pour l’opération actuelle à la surface intermédiaire.