structure D3DDDIARG_LOCKASYNC (d3dumddi.h)

Article
02/06/2025

La structure D3DDDIARG_LOCKASYNC décrit une ressource ou une surface au sein de 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 vers la ressource à verrouiller.

[in] SubResourceIndex

Index de base zéro dans la ressource qui hResource spécifie. 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.

Remarque Certains indicateurs s’excluent mutuellement avec d’autres indicateurs. Pour plus d’informations, consultez la section Remarques suivante.

[in] Range

Structure D3DDDIRANGE qui décrit la sous-plage de la ressource linéaire à verrouiller, si l’indicateur RangeValid bit-field est défini dans la structure D3DDDI_LOCKASYNCFLAGS qui indicateurs spécifie.

[in] Area

Une structure RECT qui décrit le sous-paramètre de la surface à verrouiller, si l’indicateur de champ bit AreaValid est défini dans la structure D3DDDI_LOCKASYNCFLAGS qui Indicateurs spécifie.

[in] Box

Structure D3DDDIBOX qui décrit le sous-volume du volume à verrouiller, si l’indicateur BoxValid champ binaire est défini dans la structure D3DDDI_LOCKASYNCFLAGS qui indicateurs spécifie.

[out] hCookie

Handle qui représente la ressource renommée. Ce handle n’est valide que si l’indicateur Ignorer champ binaire est défini dans la structure D3DDDI_LOCKASYNCFLAGS qui indicateurs spécifie.

[out] pSurfData

Pointeur vers la région de mémoire de la ressource 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 de lockAsync du pilote d’affichage en mode utilisateur retourne cette valeur d’emplacement au runtime Direct3D.

[out] SlicePitch

Hauteur de tranche, en octets, de la surface verrouillée. La fonction de lockAsync du pilote d’affichage en mode utilisateur retourne cette valeur de pas 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 les indicateurs de membres doivent respecter les règles suivantes :

L’indicateur de noOverwrite bit-field ne doit pas être défini simultanément avec l’indicateur Ignorer champ binaire.
Une seule des RangeValid, AreaValidet des indicateurs de champ bit-field BoxValid doivent être définis à tout moment.

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)

Voir aussi

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT

Partager via