D3DDDIARG_LOCK 结构 (d3dumddi.h)
D3DDDIARG_LOCK结构描述要锁定的资源或资源中的图面。
语法
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;
成员
[in] hResource
要锁定的资源的句柄。
[in] SubResourceIndex
资源中的从零开始的索引，由 hResource 指定的句柄指定。 此索引指示要锁定的子资源或图面。
[in] Range
描述要锁定的线性资源的子范围D3DDDIRANGE结构。
[in] Area
描述要锁定的图面的子矩形的 RECT 结构。
[in] Box
描述要锁定的卷子卷的D3DDDIBOX结构。
[out] pSurfData
指向已锁定资源的内存区域的指针。 用户模式显示驱动程序的 Lock 函数返回指向 Microsoft Direct3D 运行时的此指针。
[out] Pitch
已锁定的图面的间距（以字节为单位）。 用户模式显示驱动程序的 Lock 函数将此间距值返回到 Direct3D 运行时。
[out] SlicePitch
已锁定的图面的切片间距（以字节为单位）。 用户模式显示驱动程序的 Lock 函数将此切片间距值返回到 Direct3D 运行时。
[in] Flags
一个D3DDDI_LOCKFLAGS结构，该结构指示在位域标志中如何锁定资源。 请注意，某些标志与其他标志互斥。 有关更多信息，请参见下面的“备注”部分。
注解
由 Flags 成员指定的结构的成员必须遵守以下规则：
- 不能同时设置 ReadOnly 和 WriteOnly 位字段标志。
- 不得同时设置 NoOverwrite 位字段标志和 Discard 位字段标志。
- 在任何时候都只能设置 RangeValid、 AreaValid 和 BoxValid 位字段标志之一。
- ReadOnly 位字段标志不能与 Discard 位字段标志同时设置。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 标头 | d3dumddi.h (包括 D3dumddi.h) |