structure D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Article
02/06/2025

La structure D3DKMDT_SHADOWSURFACEDATA décrit une surface d’ombre verrouillable, qui correspond à la surface principale au format et à la résolution d’un mode d’affichage donné.

Syntaxe

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

Membres

[in] Width

Largeur de la surface, en pixels. Le pilote retourne la valeur de largeur.

[in] Height

Hauteur de la surface, en pixels. Le pilote retourne la valeur de hauteur.

[in] Format

Valeur D3DDDIFORMAT-typée qui indique le format de pixel de la surface. Le pilote retourne la valeur de format.

[out] Pitch

Largeur de la surface, en octets. Le pilote doit retourner la valeur de tangage, car la surface d’ombre est verrouillée.

Remarques

La structure D3DKMDT_SHADOWSURFACEDATA est passée par le sous-système du noyau graphique Microsoft DirectX dans un appel au du pilote miniport d’affichage DxgkDdiGetStandardAllocationDriverData fonction pour générer une description d’une surface d’ombre verrouillée. Le sous-système du noyau graphique DirectX utilise la description dans un appel au du pilote miniport d’affichage DxgkDdiCreateAllocation fonction pour créer la surface d’ombre verrouillée.

Le processeur s’appuie sur la surface d’ombre verrouillée, déverrouille la surface d’ombre, puis émet des requêtes de transfert de bloc de bits (bitblt) via la DxgkDdiPresent fonction de la surface d’ombre vers la surface principale partagée correspondante. Les demandes de transfert de bloc de bits sont également émises pour transférer des données d’une surface primaire partagée dans la surface d’ombre.

Une conversion de couleur, une opération d’étirement ou de réduction n’est pas nécessaire lors de la copie de données depuis ou vers une surface d’ombre, car les formats source et de destination et les dimensions de l’ombre et des surfaces primaires partagées correspondent toujours.