estructura de D3DDDICB_LOCK (d3dumddi.h)

La estructura D3DDDICB_LOCK describe los parámetros para bloquear una asignación.

Sintaxis

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;

Miembros

[in/out] hAllocation

Un D3DKMT_HANDLE tipo de datos que representa un identificador en modo kernel para la asignación. La función pfnAllocateCb del entorno de ejecución de Microsoft Direct3D devuelve este identificador. Por lo tanto, el controlador de pantalla en modo de usuario debe usar este identificador para bloquear la asignación.

Si la marca Descartar campo de bits está establecida en el miembro Flags , el administrador de memoria de vídeo crea una nueva instancia de la asignación y devuelve un nuevo identificador que representa la nueva instancia.

[in] PrivateDriverData

Datos privados (por ejemplo, nivel MIP) que se envían desde el controlador de pantalla en modo de usuario a la función DxgkDdiAcquireSwizzlingRange del controlador de minipuerto de pantalla.

[in] NumPages

Número de páginas de la lista de páginas a las que apunta pPages.

[in] pPages

Matriz de páginas que se van a bloquear. Cada página de la matriz se describe mediante un desplazamiento entero. Cero significa la primera página de la superficie, una significa la segunda, etc.

[out] pData

Puntero a la memoria que se devuelve del controlador de miniporte de pantalla y del administrador de memoria. Al bloquear una lista de páginas de memoria, el puntero que se devuelve es un puntero a la primera página de memoria.

[in] Flags

Estructura D3DDDICB_LOCKFLAGS que identifica, en marcas de campo de bits, cómo bloquear la asignación.

Tenga en cuenta que especificar algunas marcas juntas no es válida y que algunas marcas dependen de otras marcas. Para obtener más información sobre cómo especificar estas marcas, vea la sección Comentarios de D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

Este miembro está reservado y debe establecerse en cero.

Este miembro está disponible a partir de Windows 7.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDICB_LOCKFLAGS

DxgkDdiAcquireSwizzlingRange

pfnLockCb