structure D3DKMT_LOCK (d3dkmthk.h)

Article
02/26/2024

La structure D3DKMT_LOCK décrit les paramètres de verrouillage d’une allocation.

Syntaxe

typedef struct _D3DKMT_LOCK {
  [in]  D3DKMT_HANDLE          hDevice;
  [in]  D3DKMT_HANDLE          hAllocation;
  [in]  UINT                   PrivateDriverData;
  [in]  UINT                   NumPages;
  [in]  const UINT             *pPages;
  [out] VOID                   *pData;
  [in]  D3DDDICB_LOCKFLAGS     Flags;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DKMT_LOCK;

Membres

[in] hDevice

Un D3DKMT_HANDLE type de données qui représente un handle en mode noyau pour l’appareil auquel l’allocation est associée.

[in] hAllocation

Un D3DKMT_HANDLE type de données qui représente un handle en mode noyau à l’allocation à verrouiller.

[in] PrivateDriverData

Valeur UINT qui spécifie 32 bits de données privées (par exemple, le niveau MIP) envoyées à partir de l’ICD OpenGL vers la fonction DxgkDdiAcquireSwizzlingRange du pilote miniport d’affichage.

[in] NumPages

Nombre de pages dans la liste de pages que pPages spécifie.

[in] pPages

Tableau de pages à verrouiller. Chaque page du tableau est décrite par un décalage entier. Zéro signifie la première page de la surface, l’une signifie la deuxième, et ainsi de suite.

[out] pData

Pointeur vers la mémoire retournée par le pilote miniport d’affichage et le gestionnaire de mémoire. Lors du verrouillage d’une liste de pages mémoire, le pointeur retourné est un pointeur vers la première page mémoire.

[in] Flags

Une structure D3DDDICB_LOCKFLAGS qui identifie, dans les indicateurs de champ binaire, comment verrouiller l’allocation.

Notez que la spécification de certains indicateurs ensemble n’est pas valide et que certains indicateurs dépendent d’autres indicateurs. Pour plus d’informations sur ces combinaisons, consultez la section Remarques de D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

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

Ce membre est disponible à partir de Windows 7.