structure D3DDDI_LOCKFLAGS (d3dumddi.h)

La structure D3DDDI_LOCKFLAGS identifie comment verrouiller une ressource.

Syntaxe

typedef struct _D3DDDI_LOCKFLAGS {
  union {
    struct {
      UINT ReadOnly : 1;
      UINT WriteOnly : 1;
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT RangeValid : 1;
      UINT AreaValid : 1;
      UINT BoxValid : 1;
      UINT NotifyOnly : 1;
      UINT MightDrawFromLocked : 1;
      UINT DoNotWait : 1;
      UINT Reserved : 22;
    };
    UINT Value;
  };
} D3DDDI_LOCKFLAGS;

Membres

ReadOnly

Valeur UINT qui spécifie si la ressource verrouillée peut uniquement être lue. Définir ce membre équivaut à définir le premier bit du membre Value 32 bits (0x00000001).

WriteOnly

Valeur UINT qui spécifie si la ressource verrouillée peut uniquement être écrite dans. La définition de ce membre équivaut à définir le deuxième bit du membre Value 32 bits (0x00000002).

NoOverwrite

Valeur UINT qui spécifie si la ressource verrouillée peut avoir des données ajoutées à celle-ci, mais si les données existantes dans la ressource ne peuvent pas être modifiées. Ce membre est utilisé uniquement avec les verrous de mémoire tampon de vertex Direct3D.

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

Discard

Valeur UINT qui spécifie si la ressource verrouillée entière est modifiée. Par conséquent, étant donné que le contenu existant peut être ignoré, il ne nécessite aucun traitement préliminaire.

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

RangeValid

Valeur UINT qui spécifie si la ressource verrouillée est linéaire.

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

AreaValid

Valeur UINT qui spécifie si la ressource verrouillée est une surface.

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

BoxValid

Valeur UINT qui spécifie si la ressource verrouillée est un volume.

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

NotifyOnly

Valeur UINT qui spécifie si l’appel de verrouillage est à des fins de notification uniquement.

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

MightDrawFromLocked

Valeur UINT qui spécifie si le pilote est éventuellement invité à dessiner à partir d’une mémoire tampon de vertex, même si la mémoire tampon de vertex est verrouillée par le runtime Direct3D. MightDrawFromLocked ne garantit pas que le pilote recevra des appels à ses fonctions DrawIndexedPrimitive, DrawIndexedPrimitive2, DrawPrimitive et DrawPrimitive2 après l’appel à Verrouiller. MightDrawFromLocked est défini uniquement sur les tampons de vertex qui ont été créés avec l’indicateur de champ de bits MightDrawFromLocked défini dans le membre Flags de la structure D3DDDIARG_CREATERESOURCE pendant la création.

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

DoNotWait

Valeur UINT qui spécifie si le pilote d’affichage en mode utilisateur doit attendre que la ressource devienne inactive. La définition de DoNotWait indique que le pilote d’affichage en mode utilisateur ne doit pas attendre que la ressource devienne inactive.

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

Reserved

Ce membre est réservé et doit être défini sur zéro. Définir ce membre sur zéro équivaut à définir les 22 bits restants (0xFFFFFC00) du membre Value 32 bits sur zéros.

Value

Membre de l’union contenu dans D3DDDI_LOCKFLAGS qui peut contenir une valeur 32 bits qui identifie comment verrouiller une ressource.

Configuration requise

Voir aussi

D3DDDIARG_LOCK