structure D3DDDIARG_COPYFLAGS (d3dumddi.h)

  • Article

Décrit comment gérer le contenu existant d’une ressource lors d’une opération de copie ou de mise à jour d’une région au sein de cette ressource. Utilisé par les pilotes d’affichage en mode utilisateur Windows (WDDM) 1.3 et versions ultérieures.

Syntaxe

typedef struct D3DDDIARG_COPYFLAGS {
  union {
    struct {
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT Reserved1 : 22;
      UINT BoxValid : 1;
      UINT Reserved2 : 7;
    };
    UINT Value;
  };
} D3DDDIARG_COPYFLAGS;

Membres

NoOverwrite

Spécifie que l’appelant garantit que la partie de la surface en cours d’écriture avec de nouvelles données n’est pas actuellement référencée ou accessible par une opération de rendu précédente. Le pilote peut tirer parti de cette fonctionnalité pour optimiser les performances et l’utilisation de la mémoire.

Définir ce membre équivaut à définir le premier bit du membre Value 32 bits (0x00000001).

Discard

Spécifie que le pilote d’affichage en mode utilisateur peut ignorer le contenu précédent de l’ensemble de la ressource. Le pilote peut tirer parti de cette fonctionnalité pour optimiser les performances et l’utilisation de la mémoire.

La définition de ce membre équivaut à définir le deuxième bit du membre Value 32 bits (0x00000002).

Reserved1

Ce membre est réservé et doit être défini sur zéro.

Définir ce membre sur zéro équivaut à définir les bits 3 à 24 (0x00FFFFFC) du membre Value 32 bits sur zéros.

BoxValid

Spécifie qu’une région de destination de la sous-ressource vers laquelle être copiée est valide. Lorsqu’elle n’est pas définie, la sous-ressource entière doit être mise à jour.

La définition de ce membre équivaut à définir le vingt-cinquième bit du membre Value 32 bits (0x01000000).

Reserved2

Ce membre est réservé et doit être défini sur zéro.

Définir ce membre sur zéro équivaut à définir les bits 26 à 32 (0xFE000000) du membre Valeur 32 bits sur zéros.

Value

Membre de l’union que contient D3DDDIARG_COPYFLAGS peut contenir une valeur 32 bits qui identifie comment gérer le contenu existant d’une ressource pendant une opération de copie ou de mise à jour.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1
Serveur minimal pris en charge Windows Server 2012 R2
En-tête d3dumddi.h (include D3d10umddi.h)

Voir aussi

D3DDDIARG_UPDATESUBRESOURCEUP