estructura de D3DDDIARG_LOCKASYNC (d3dumddi.h)
La estructura D3DDDIARG_LOCKASYNC describe un recurso o una superficie dentro del recurso que se va a bloquear.
Sintaxis
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;
Miembros
[in] hResource
Identificador del recurso que se va a bloquear.
[in] SubResourceIndex
Índice de base cero en el recurso que hResource especifica. Este índice indica el subrecurso o la superficie que se va a bloquear.
[in] Flags
Estructura D3DDDI_LOCKASYNCFLAGS que indica, en marcas de campo de bits, cómo bloquear el recurso.
[in] Range
Estructura D3DDDIRANGE que describe el subrango del recurso lineal que se va a bloquear, si la marca de campo de bits RangeValid está establecida en la estructura D3DDDI_LOCKASYNCFLAGS que especifica Flags .
[in] Area
Estructura RECT que describe el subrectangle de la superficie que se va a bloquear, si la marca de campo de bits AreaValid está establecida en la estructura D3DDDI_LOCKASYNCFLAGS que Flags especifica.
[in] Box
Estructura de D3DDDIBOX que describe el subvolumen del volumen que se va a bloquear, si la marca de campo de bits BoxValid está establecida en la estructura de D3DDDI_LOCKASYNCFLAGS que especifica Flags .
[out] hCookie
Identificador que representa el recurso cuyo nombre ha cambiado. Este identificador solo es válido si la marca Descartar campo de bits está establecida en la estructura de D3DDDI_LOCKASYNCFLAGS que especifica Flags .
[out] pSurfData
Puntero a la región de memoria del recurso bloqueado. La función LockAsync del controlador de pantalla en modo de usuario devuelve este puntero al entorno de ejecución de Microsoft Direct3D.
[out] Pitch
Tono, en bytes, de la superficie bloqueada. La función LockAsync del controlador de pantalla en modo de usuario devuelve este valor de tono al tiempo de ejecución de Direct3D.
[out] SlicePitch
Tono de segmento, en bytes, de la superficie bloqueada. La función LockAsync del controlador de pantalla en modo de usuario devuelve este valor de tono de segmento al tiempo de ejecución de Direct3D.
GpuVirtualAddress
Este miembro está reservado y debe establecerse en cero.
Este miembro está disponible a partir de Windows 7.
Comentarios
Los miembros de la estructura D3DDDI_LOCKASYNCFLAGS que especifica el miembro Flags deben cumplir las reglas siguientes:
- La marca de campo de bits NoOverwrite no debe establecerse simultáneamente con la marca Descartar campo de bits.
- Solo se debe establecer una de las marcas rangeValid, AreaValid y BoxValid de campo de bits en cualquier momento.
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) |