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 pantalla en modo de usuario devuelve este puntero al tiempo de ejecución de Microsoft Direct3D.
[out] Pitch
Tono, en bytes, de la superficie bloqueada. La función Lock 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 Lock del controlador de visualización 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 son mutuamente excluyentes con otras marcas. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
Comentarios
Los miembros de la estructura especificada por el miembro Flags deben cumplir las reglas siguientes:
- Las marcas de campo de bits ReadOnly y WriteOnly no se deben establecer simultáneamente.
- 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.
- La marca de campo de bits ReadOnly no debe establecerse simultáneamente con la marca Descartar campo de bits.
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) |