structure D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Article
05/18/2024

La structure D3DKMDT_SHADOWSURFACEDATA décrit une surface d’ombre verrouillable, qui correspond à la surface primaire dans le format et la résolution pour 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 height.

[in] Format

Valeur de type D3DDDIFORMAT qui indique le format de pixels 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 pas, car la surface d’ombre est verrouillable.

Remarques

La structure D3DKMDT_SHADOWSURFACEDATA est passée 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 d’ombre verrouillable. Le sous-système du noyau graphique DirectX utilise la description dans un appel à la fonction DxgkDdiCreateAllocation du pilote miniport d’affichage pour créer la surface d’ombre verrouillable.

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

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