Partager via


structure D3DDDICB_LOCK (d3dumddi.h)

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

Syntaxe

typedef struct _D3DDDICB_LOCK {
  [in/out] D3DKMT_HANDLE          hAllocation;
  [in]     UINT                   PrivateDriverData;
  [in]     UINT                   NumPages;
  [in]     const UINT             *pPages;
  [out]    VOID                   *pData;
  [in]     D3DDDICB_LOCKFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDICB_LOCK;

Membres

[in/out] hAllocation

Type de données D3DKMT_HANDLE qui représente un handle en mode noyau à l’allocation. La fonction pfnAllocateCb du runtime Microsoft Direct3D retourne ce handle. Par conséquent, le pilote d’affichage en mode utilisateur doit utiliser ce handle pour verrouiller l’allocation.

Si l’indicateur Ignorer champ binaire est défini dans le membre indicateurs de, le gestionnaire de mémoire vidéo crée une nouvelle instance de l’allocation et retourne un nouveau handle qui représente la nouvelle instance.

[in] PrivateDriverData

Données privées (par exemple, niveau MIP) envoyées du pilote d’affichage en mode utilisateur au de la fonction DxgkDdiAcquireSwizlingRange du pilote d’affichage.

[in] NumPages

Nombre de pages dans la liste des pages pointées par pPages.

[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, une signifie la seconde, 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 de mémoire.

[in] Flags

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 la spécification de ces indicateurs, 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.

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

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb