D3DDDIARG_LOCKASYNC structure (d3dumddi.h)

Article
08/07/2023

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

Syntaxe

typedef struct _D3DDDIARG_LOCKASYNC {
  [in]  HANDLE                 hResource;
  [in]  UINT                   SubResourceIndex;
  [in]  D3DDDI_LOCKASYNCFLAGS  Flags;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] HANDLE                 hCookie;
  [out] VOID                   *pSurfData;
  [out] UINT                   Pitch;
  [out] UINT                   SlicePitch;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;

Membres

[in] hResource

Handle de la ressource à verrouiller.

[in] SubResourceIndex

Index de base zéro dans la ressource spécifiée par hResource . Cet index indique la sous-ressource ou la surface à verrouiller.

[in] Flags

Structure D3DDDI_LOCKASYNCFLAGS qui indique, dans les indicateurs de champ binaire, comment verrouiller la ressource.

Note Certains indicateurs s’excluent mutuellement avec d’autres. Pour plus d'informations, consultez la section Notes qui suit.

[in] Range

Structure D3DDDIRANGE qui décrit la sous-plage de la ressource linéaire à verrouiller, si l’indicateur de champ de bits RangeValid est défini dans la structure D3DDDI_LOCKASYNCFLAGS spécifiée par Flags .

[in] Area

Structure RECT qui décrit la sous-correction de la surface à verrouiller, si l’indicateur de champ binaire AreaValid est défini dans la structure D3DDDI_LOCKASYNCFLAGS spécifiée par Flags .

[in] Box

Structure D3DDDIBOX qui décrit le sous-volume du volume à verrouiller, si l’indicateur de champ de bits BoxValid est défini dans la structure D3DDDI_LOCKASYNCFLAGS spécifiée par Flags .

[out] hCookie

Handle qui représente la ressource renommée. Ce handle est valide uniquement si l’indicateur ignorer le champ binaire est défini dans la structure D3DDDI_LOCKASYNCFLAGS spécifiée par Flags .

[out] pSurfData

Pointeur vers la région de mémoire de la ressource qui a été verrouillée. La fonction LockAsync 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 LockAsync 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 LockAsync du pilote d’affichage en mode utilisateur retourne cette valeur de pitch de tranche au runtime Direct3D.

GpuVirtualAddress

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

Ce membre est disponible à partir de Windows 7.

Remarques

Les membres de la structure D3DDDI_LOCKASYNCFLAGS que le membre Flags spécifie doivent respecter les règles suivantes :

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.

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_LOCKASYNCFLAGS

LockAsync

RECT

Partager via