structure D3DDDI_LOCKASYNCFLAGS (d3dumddi.h)
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 y être ajoutée, mais les données existantes de la ressource ne peuvent pas être modifiées. Ce membre est utilisé uniquement avec les verrous de mémoire tampon de vertex Microsoft Direct3D.
La définition de ce membre équivaut à définir le premier bit du membre valeur de 32 bits (0x00000001).
Discard
Valeur UINT qui spécifie si l’intégralité de la ressource verrouillée 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 valeur 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 valeur 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 valeur 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 valeur 32 bits membre (0x00000010).
NoExistingReferences
Valeur UINT qui spécifie si le runtime Microsoft Direct3D a 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 binaire NoExistingReferences de la structure D3DDDICB_LOCK lorsque le pilote appelle la fonction pfnLockCb pour effectuer une opération d’abandon de verrou.
La définition de ce membre équivaut à définir le sixième bit du membre valeur de 32 bits (0x00000020).
NotifyOnly
Valeur UINT qui spécifie si l’appel de verrou est destiné uniquement à la notification. Le runtime Direct3D définit NotifyOnly pour TRUE lorsqu’il verrouille les surfaces de mémoire système allouées au runtime. Dans ce cas, le runtime ignore le pointeur retourné par le pilote dans le pSurfData membre de la structure D3DDDIARG_LOCKASYNC.
La définition de ce membre équivaut à définir le septième bit du membre valeur 32 bits (0x00000040).
Reserved
Ce membre est réservé et doit être défini sur zéro. La définition de ce membre sur zéro équivaut à définir les 25 bits restants (0xFFFFFF80) de la valeur valeur 32 bits membre 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |