estructura D3DDDIARG_LOCK (d3dumddi.h)
La estructura D3DDDIARG_LOCK describe un recurso o una superficie dentro del recurso que se va a bloquear.
Sintaxis
typedef struct _D3DDDIARG_LOCK {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
[in] D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;
Miembros
[in] hResource
Identificador del recurso que se va a bloquear.
[in] SubResourceIndex
Índice de base cero en el recurso, especificado por el identificador especificado por hResource. Este índice indica el subrecurso o la superficie que se va a bloquear.
[in] Range
Estructura D3DDDIRANGE que describe el subrango del recurso lineal que se va a bloquear.
[in] Area
Estructura RECT que describe el subrectangle de la superficie que se va a bloquear.
[in] Box
Estructura D3DDDIBOX que describe el subvolumen del volumen que se va a bloquear.
[out] pSurfData
Puntero a la región de memoria del recurso bloqueado. La función Lock del controlador de visualización en modo de usuario devuelve este puntero al entorno de ejecución de Microsoft Direct3D.
[out] Pitch
El tono, en bytes, de la superficie bloqueada. La función Lock del controlador de visualización 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 Bloquear del controlador de pantalla en modo de usuario devuelve este valor de tono de segmento al tiempo de ejecución de Direct3D.
[in] Flags
Estructura D3DDDI_LOCKFLAGS que indica, en marcas de campo de bits, cómo bloquear el recurso. Tenga en cuenta que algunas marcas se excluyen mutuamente con otras marcas. Para obtener más información, vea la siguiente sección Comentarios.
Observaciones
Los miembros de la estructura especificada por el miembro Flags deben cumplir las siguientes reglas:
- Los ReadOnly y WriteOnly marcas de campo de bits no deben establecerse simultáneamente.
- El noOverwrite marca de campo de bits no debe establecerse simultáneamente con la marca Descartar campo de bits.
- Solo uno de los RangeValid, AreaValidy BoxValid marcas de campo de bits deben establecerse en cualquier momento.
- La marca readOnly campo de bits no debe establecerse simultáneamente con la marca de campo de bits descartar.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | d3dumddi.h (incluya D3dumddi.h) |