énumération D3DKMDT_GDISURFACETYPE (d3dkmdt.h)

  • Article

L’énumération D3DKMDT_GDISURFACETYPE indique le type de surface verrouillable utilisée par desktop Window Manager (DWM) pour la redirection.

Syntax

typedef enum _D3DKMDT_GDISURFACETYPE {
  D3DKMDT_GDISURFACE_INVALID,
  D3DKMDT_GDISURFACE_TEXTURE,
  D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE,
  D3DKMDT_GDISURFACE_STAGING,
  D3DKMDT_GDISURFACE_LOOKUPTABLE,
  D3DKMDT_GDISURFACE_EXISTINGSYSMEM,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE,
  D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER
} D3DKMDT_GDISURFACETYPE;

Constantes

 
D3DKMDT_GDISURFACE_INVALID
Le pilote ne doit pas voir cette valeur.
D3DKMDT_GDISURFACE_TEXTURE
Indique que la surface a les propriétés suivantes :



  • Il a une texture à un niveau.



  • Il n’est pas visible par le processeur et le gestionnaire de mémoire vidéo le crée en tant que surface partagée.



  • Il est ouvert par un pilote en mode utilisateur et utilisé comme texture lors de la composition DWM.



  • Il est utilisé par un pilote en mode utilisateur comme cible de rendu pour le rendu DirectX.



  • Il est utilisé comme surface source ou de destination dans les opérations d’accélération matérielle GDI.
D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE
Indique que la surface a les propriétés suivantes :



  • Il est visible par le processeur et sera largement utilisé par le processeur. L’allocation doit être un format linéaire et dans un segment d’ouverture GPU cohérent dans le cache.



  • Il est utilisé comme surface source dans les opérations gDI accélérées par le matériel.



  • Il est utilisé comme surface de destination dans les opérations GDI bitblt (copie uniquement).



  • Son emplacement doit être retourné par le pilote du miniport d’affichage.



  • Sa valeur de tangage et son adresse de surface doivent être alignées sur la valeur du membre AlignmentShift de la structure DXGK_PRESENTATIONCAPS (autrement dit, DXGK_DRIVERCAPS-PresentationCaps.AlignmentShift>).
D3DKMDT_GDISURFACE_STAGING
Indique que la surface a les propriétés suivantes :



  • Il n’est pas visible par le processeur.



  • Il est utilisé comme surface source ou de destination dans les opérations d’accélération matérielle GDI.



  • Il est utilisé comme surface source ou de destination dans les opérations de bitblt GDI (copie uniquement).
D3DKMDT_GDISURFACE_LOOKUPTABLE
Indique que la surface a les propriétés suivantes :



  • Il n’est pas visible par le processeur.



  • Il est utilisé uniquement lors du traitement des commandes spécifiées par ClearTypeBlend et OpCode. DXGK_GDIOP_BITBLT membres (copie uniquement) de la structure DXGK_RENDERKM_COMMAND .



  • Le format est défini par la valeur D3DDDIFMT_A8 de l’énumération D3DDDIFORMAT .



  • L’allocation de recherche gamma est créée une seule fois et ne change jamais après son initialisation. L’allocation est initialisée dans D3DDDIFMT_A8 format en émettant une commande DXGK_RENDERKM_COMMAND-Opcode.DXGK_GDIOP_BITBLT> à partir d’une surface D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE.
D3DKMDT_GDISURFACE_EXISTINGSYSMEM
Indique que la surface a les propriétés suivantes :



  • Il est visible par le processeur. L’allocation doit être un format linéaire et dans un segment d’ouverture GPU cohérent dans le cache.



  • Sa valeur de tangage et son adresse de surface doivent être alignées sur la valeur du membre AlignmentShift de la structure DXGK_PRESENTATIONCAPS (autrement dit, DXGK_DRIVERCAPS-PresentationCaps.AlignmentShift>).



  • L’adresse de surface est passée au pilote.



  • Cette valeur est utilisée de la même façon que la valeur D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE.
D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE
Réservé pour le système. N’utilisez pas cette valeur dans votre pilote.

Pris en charge à partir de Windows 8.
D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER
Indique que la surface a les propriétés suivantes :



  • Il n’est pas visible par le processeur et le gestionnaire de mémoire vidéo le crée en tant que surface croisée partagée.



  • Son tangage doit être retourné par le pilote de miniport d’affichage dans le membre Pitch de la structure D3DKMDT_GDISURFACEDATA .



  • Le tangage et la hauteur doivent avoir l’alignement requis pour la ressource d’adaptateur croisé. Vous pouvez utiliser les constantes D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT et D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT pour vérifier que le pilote retourne la hauteur et la hauteur correctes pour la ressource d’adaptateurs croisés. Ces constantes sont définies dans D3dukmdt.h.



Pris en charge à partir de Windows 8.1.
D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER
Réservé pour le système. N’utilisez pas cette valeur dans votre pilote.

Pris en charge à partir de Windows 8.1.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 7 et versions ultérieures des systèmes d’exploitation Windows.
En-tête d3dkmdt.h

Voir aussi

D3DDDIFORMAT

D3DKMDT_GDISURFACEDATA

DXGK_DRIVERCAPS

DXGK_PRESENTATIONCAPS

DXGK_RENDERKM_COMMAND