structure D3DDDI_LOCKASYNCFLAGS (d3dumddi.h)

  • Article

La structure D3DDDI_LOCKASYNCFLAGS identifie comment verrouiller une ressource.

Syntaxe

typedef struct _D3DDDI_LOCKASYNCFLAGS {
  union {
    struct {
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT RangeValid : 1;
      UINT AreaValid : 1;
      UINT BoxValid : 1;
      UINT NoExistingReferences : 1;
      UINT NotifyOnly : 1;
      UINT Reserved : 25;
    };
    UINT Value;
  };
} D3DDDI_LOCKASYNCFLAGS;

Membres

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 Microsoft Direct3D.

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

Discard

Valeur UINT qui spécifie si la ressource verrouillée entière est modifiée. Si cette valeur est définie, car le contenu existant peut être ignoré, le contenu ne nécessite aucun traitement préliminaire.

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

RangeValid

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

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

AreaValid

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

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

BoxValid

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

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

NoExistingReferences

Valeur UINT qui spécifie si le runtime Microsoft Direct3D contient des références en file d’attente à la ressource à verrouiller. Si NoExistingReferences est défini, le pilote détermine qu’aucune référence en file d’attente interne à la ressource n’est disponible. Le pilote peut ensuite définir l’indicateur de champ bit NoExistingReferences de la structure D3DDDICB_LOCK lorsque le pilote appelle la fonction pfnLockCb pour effectuer une opération lock-discard.

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

NotifyOnly

Valeur UINT qui spécifie si l’appel de verrouillage est à des fins de notification uniquement. Le runtime Direct3D définit NotifyOnly sur TRUE lorsqu’il verrouille les surfaces de mémoire système allouées au runtime. Dans ce cas, le runtime ignore le pointeur que le pilote retourne dans le membre pSurfData de la structure D3DDDIARG_LOCKASYNC .

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

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 25 bits restants (0xFFFFFF80) du membre Value 32 bits sur zéros.

Value

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_LOCKASYNC