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
Un D3DKMT_HANDLE type de données qui représente un handle en mode noyau pour 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 le champ de bits est défini dans le membre Indicateurs, 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 à partir du pilote d’affichage en mode utilisateur vers la fonction DxgkDdiAcquireSwizzlingRange du pilote miniport d’affichage.
[in] NumPages
Nombre de pages dans la liste de 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, 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 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |