D3DDDIARG_LOCK structure (d3dumddi.h)

Article
08/07/2023

La structure D3DDDIARG_LOCK décrit une ressource ou une surface dans la ressource à verrouiller.

Syntaxe

typedef struct _D3DDDIARG_LOCK {
  [in]  HANDLE           hResource;
  [in]  UINT             SubResourceIndex;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] VOID             *pSurfData;
  [out] UINT             Pitch;
  [out] UINT             SlicePitch;
  [in]  D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;

Membres

[in] hResource

Handle de la ressource à verrouiller.

[in] SubResourceIndex

Index de base zéro dans la ressource, qui est spécifié par le handle spécifié par hResource. Cet index indique la sous-ressource ou la surface à verrouiller.

[in] Range

Structure D3DDDIRANGE qui décrit la sous-plage de la ressource linéaire à verrouiller.

[in] Area

Structure RECT qui décrit le sous-ensemble de la surface à verrouiller.

[in] Box

Structure D3DDDIBOX qui décrit le sous-volume du volume à verrouiller.

[out] pSurfData

Pointeur vers la région de mémoire de la ressource qui a été verrouillée. La fonction Lock du pilote d’affichage en mode utilisateur retourne ce pointeur vers le runtime Microsoft Direct3D.

[out] Pitch

Hauteur, en octets, de la surface verrouillée. La fonction Lock du pilote d’affichage en mode utilisateur retourne cette valeur de pitch au runtime Direct3D.

[out] SlicePitch

Pitch de tranche, en octets, de la surface verrouillée. La fonction Lock du pilote d’affichage en mode utilisateur retourne cette valeur de pitch de tranche au runtime Direct3D.

[in] Flags

Structure D3DDDI_LOCKFLAGS qui indique, dans les indicateurs de champ binaire, comment verrouiller la ressource. Notez que certains indicateurs s’excluent mutuellement avec d’autres indicateurs. Pour plus d'informations, consultez la section Notes qui suit.

Remarques

Les membres de la structure spécifiée par le membre Flags doivent respecter les règles suivantes :

Les indicateurs de champ binaire ReadOnly et WriteOnly ne doivent pas être définis simultanément.
L’indicateur de champ de bits NoOverwrite ne doit pas être défini simultanément avec l’indicateur Ignorer le champ binaire.
Un seul des indicateurs de champ binaire RangeValid, AreaValid et BoxValid doit être défini à tout moment.
L’indicateur de champ de bits ReadOnly ne doit pas être défini simultanément avec l’indicateur Ignorer le champ binaire.

Configuration requise

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

Voir aussi

D3DDDI_LOCKFLAGS

Verrou

Partager via